Geliştirici

Projelerinizi API ile yönetin

Panelden yaptığınız her şeyi bir uygulama ya da yapay zekâ ajanı da yapabilir: proje ekleme, düzenleme, doküman ve ölçüm girme, incelemeye gönderme. Tek gereken siteden ürettiğiniz bir erişim token'ı.

01Token üretin

Ayarlar sayfasında bir token üretin ve ona nerede kullanacağınızı anlatan bir ad verin. Token yalnızca üretildiği anda gösterilir; veritabanında sadece özeti saklanır, kaybederseniz kurtarılamaz — yenisini üretirsiniz.

Ayarlar sayfasına git →

02Kimlik doğrulama

Her isteğe token'ı başlık olarak ekleyin.

Authorization: Bearer traip_xxxxxxxxxxxxxxxxxxxx

Token neye erişir

Token sahibinin yetkisiyle çalışır ve yalnızca onun projelerine erişir.
Başkasına ait bir kayıt 404 döner — 403 değil. Böylece başka bir hesabın çalışması olduğu bilgisi bile sızmaz.
Token'ı ayarlar sayfasından iptal edebilirsiniz; iptal anında geçersiz olur.

03Uçlar

Taban adreshttps://traip.org/api/v1

GET	/me	Token kime ait
GET	/projects	Projelerinizi listeler
POST	/projects	Taslak oluşturur
GET	/projects/{id}	Tek projeyi tüm ayrıntısıyla getirir
PATCH	/projects/{id}	Yalnızca gönderdiğiniz alanları değiştirir
POST	/projects/{id}/submit	İncelemeye gönderir
POST	/projects/{id}/unpublish	Yayından çeker
GET POST	/projects/{id}/docs	Dokümantasyon bağlantıları
GET POST	/projects/{id}/metrics	Ölçümler
GET POST	/projects/{id}/releases	Sürüm geçmişi
GET POST	/projects/{id}/members	Ekip künyesi
DELETE	/projects/{id}/{koleksiyon}/{itemId}	Tek kalem siler
PUT DELETE	/projects/{id}/logo	Proje logosu (multipart, alan adı file)
PUT DELETE	/projects/{id}/cover	Kapak görseli (multipart, alan adı file)
GET	/projects/{id}/messages	Gelen mesajlar

04Örnek: proje oluşturma

Kullanmadığınız isteğe bağlı alanları hiç göndermeyebilirsiniz. Proje taslak olarak oluşur.

curl -X POST https://traip.org/api/v1/projects \
  -H "Authorization: Bearer $TRAIP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ses Ayrıştırıcı",
    "tagline": "Toplantı kayıtlarını konuşmacılara ayırır",
    "overview": "## Ne yapar\n\nÇok kişili ses kayıtlarını...",
    "field": "SPEECH",
    "stage": "BETA",
    "demoKind": "CODE",
    "repoUrl": "https://github.com/ornek/ses-ayristirici"
  }'

05Hatalar

Başarısız istekler şu gövdeyi döner:

{
  "error": "validation_failed",
  "message": "Girdiler geçerli değil.",
  "details": { "tagline": "En az 20 karakter yazın." }
}

06MCP sunucusu

Model Context Protocol konuşan bir asistan kullanıyorsanız (Claude Desktop gibi), aynı API araç olarak hazır — HTTP yazmanıza gerek kalmaz. Sunucu depodaki mcp/server.ts dosyasıdır; komutu depo kökünde çalıştırın. Yapılandırmanıza şunu ekleyin:

{
  "mcpServers": {
    "traip": {
      "command": "npx",
      "args": ["-y", "tsx", "mcp/server.ts"],
      "env": {
        "TRAIP_TOKEN": "traip_xxxxxxxxxxxxxxxxxxxx",
        "TRAIP_URL": "https://traip.org/"
      }
    }
  }
}

Araçlar

whoamilist_projectsget_projectcreate_projectupdate_projectsubmit_projectunpublish_projectadd_documentadd_metricadd_releaseadd_team_memberremove_itemlist_messages

Sunucu ince bir sarmalayıcıdır: bütün kurallar API'de durur, dolayısıyla bir araç API'nin reddedeceği hiçbir şeyi yapamaz.