API Referansı

SoliAgile REST API

Çok kiracılı takım ve issue yönetimi için tam REST API. İnteraktif Swagger UI ve makine-okunur OpenAPI spec ile keşfedin; kendi entegrasyonunuzu üretin.

İnteraktif Swagger UI

Tüm endpoint'leri tarayıcıda gezin, şemaları görün ve denemeleri çalıştırın.

https://api.soliagile.com/api/docs

OpenAPI JSON spec

İndirilebilir spec — istemci/SDK üretimi ve harici araçlar için.

https://api.soliagile.com/api/docs-json

Kimlik doğrulama

Tüm istekler Authorization: Bearer <token> ister. İki tür token kabul edilir:

API anahtarı (sa_...)

Tenant kapsamlı kalıcı anahtar. SDK/MCP ve sunucu-sunucu entegrasyonlar bunu kullanır. Tenant ayarları → API Keys (Business+ plan).

Zitadel JWT

İnteraktif kullanıcı oturumu (web/admin) için access token.

Tüm kaynak endpoint'leri x-tenant-id başlığı ister (API anahtarı zaten tek tenant'a bağlıdır).

Örnek istek

curl https://api.soliagile.com/api/v1/issues \
  -H "Authorization: Bearer sa_..." \
  -H "x-tenant-id: <tenant-id>"

Cursor sayfalama

Liste endpoint'leri cursor tabanlıdır: { items, endCursor, hasNextPage }. Sonraki sayfa için endCursor'ı after olarak geçin.

TypeScript SDK'sı MCP sunucusu