Geliştirici Dokümantasyonu

STK Kurumsal platformu, üye yönetiminden muhasebeye tüm modülleri REST API üzerinden sunar. Bu bölüm; API mimarisi, kimlik doğrulama akışı, yanıt/hata formatı ve entegrasyon esaslarını açıklar.

STK Kurumsal API'si şu an platform-içi kullanım (mobil uygulama, işletme ve yönetim panelleri) içindir. Kurumunuza özel bir entegrasyon veya API erişimi için iletişime geçin.

Base URL

Tüm istekler aşağıdaki temel adres üzerinden yapılır:

https://api.seteka.com

Yanıt Formatı

Tüm uç noktalar tutarlı bir zarf (envelope) döner. Başarılı yanıt:

{
  "success": true,
  "data": { /* kaynak */ }
}

Hatalı yanıt:

{
  "success": false,
  "error": { "code": "VALIDATION", "message": "Açıklama" }
}

Kimlik Doğrulama JWT access + refresh token akışı, oturum yenileme. İncele Hata Kodları HTTP durumları ve standart hata kodları referansı. İncele API Referansı Oturum, kurum, üyelik, aidat, bağış ve ödeme uç noktaları. İncele

Kimlik Doğrulama (özet)

API, kısa ömürlü JWT access token (Authorization: Bearer) + refresh token modeli kullanır. Access token süresi dolduğunda /auth/refresh ile yenilenir. Ayrıntı için Kimlik Doğrulama sayfasına bakın.

Authorization: Bearer <access_token>

Hız Limitleri

Kötüye kullanımı önlemek için uç noktalar Redis tabanlı hız sınırlamasına tabidir. Limit aşımında 429 Too Many Requests döner. Toplu işlemler için istekleri makul aralıklarla gönderin.

Hata Modeli

Hatalar standart HTTP durum kodları + gövdedeki error.code / error.message ile iletilir. Tam liste için Hata Kodları.

Entegrasyon mu planlıyorsunuz?

Kurumunuza özel API erişimi ve teknik destek için ekibimizle görüşün.

İletişime geç