Kladim API Docs

Sıkça Sorulan Sorular (SSS)

Token gerçekten 7 gün mü geçerli? Süreyi uzatabilir miyim?

Evet, bearer token 7 gün geçerlidir. Süre dolmadan önce yeni token almanız gerekir. Süre uzatma işlemi yoktur; tekrar login endpoint'iyle yeni token alın.

Token’ı nereye koymalıyım?

Tüm API çağrılarında HTTP header içine eklenmelidir:

Authorization: Bearer eyJhbGciOi...

IP kısıtlaması gerekiyor mu?

Varsayılan olarak gerekmez. Güvenlik politikalarınız gerektiriyorsa destek bileti açarak IP bazlı kısıtlama talep edebilirsiniz.

Ortalama rate limit nedir?

Normal kullanımda dakikada birkaç yüz çağrı desteklenir. Yüksek hacimli entegrasyonlarda limit artışı talep edebilirsiniz.

Hata kodlarını nasıl yorumlamalıyım?

  • 400 – Eksik veya hatalı parametre
  • 401 – Geçersiz veya süresi dolmuş token
  • 403 – Yetkisiz işlem
  • 404 – Kaynak bulunamadı
  • 429 – Çok sık istek (rate limit)
  • 500+ – Sunucu tarafı hata, daha sonra tekrar deneyin

Yanıt tarih formatı nedir?

Tüm tarih/saat alanları UTC ISO-8601 formatındadır: 2025-10-22T14:30:00Z

Liste endpointlerinde sayfalama var mı?

Evet. Listeleyen endpoint'lerde genellikle page ve pageSize parametreleri bulunur. Varsayılan pageSize genellikle 50’dir.

Webhook desteği var mı?

Varsayılan olarak pasiftir. Yedek tamamlandı, hata oluştu gibi olaylar için webhook desteği istenirse etkinleştirilebilir. Destek bileti ile talep edin.

CORS desteği var mı?

Sunucu taraflı çağrılar önerilir. Doğrudan tarayıcı üzerinden erişim gerekiyorsa destek ekibinden domain izin listesi talep edin.

Veriler nerede saklanıyor?

Veriler Türkiye lokasyonlu veri merkezlerinde, KVKK uyumlu olarak saklanmaktadır.

SDK veya örnek kod sağlıyor musunuz?

Evet, dokümantasyon içinde PHP ve cURL örnekleri mevcuttur. Delphi, Node.js vb. örnekler talep üzerine paylaşılabilir.

Destek ile nasıl iletişime geçebilirim?

Destek bileti açarak teknik ekibimize ulaşabilirsiniz.

Yeni sık sorulan sorular geldikçe bu sayfa güncellenir.