Ortamlar
Staging
Bölüm başlığı “Staging”Entegrasyon geliştirme ve testler için staging ortamı kullanılır:
| Temel adres | https://tfs-api.karyabilisim.com |
| Kimlik doğrulama | OIDC Bearer jetonu (Keycloak); geliştirici başlıkları yalnızca yedek — bkz. Kimlik doğrulama |
| Veri | Sentetik test verisi; gerçek müşteri verisi bulunmaz |
| Sıfırlama | Staging verisi bildirimli olarak periyodik sıfırlanabilir |
Staging, üretimle aynı kod tabanından dağıtılır; iş kuralları ve hata sözleşmesi birebir aynıdır.
Üretim
Bölüm başlığı “Üretim”Üretim adresi kiracıya özeldir ve sözleşme sürecinde tanımlanır
(ör. https://api.<kurumunuz>.karyabilisim.com veya kendi alan adınız).
Üretimde kimlik doğrulama OIDC iledir; geliştirici başlıkları kapalıdır.
İstek kuralları
Bölüm başlığı “İstek kuralları”Content-Type: application/json; charset=utf-8- Tüm iş uçları
/api/v1/...önekiyle sunulur; kimlik doğrulama gerektirmeyen uçlar/api/public/...altındadır. - İdempotans gerektiren yazma uçları
Idempotency-Keybaşlığını destekler; aynı anahtarla tekrarlanan istek ilk sonucun aynısını döndürür. - Sayfalı listelerde
page(0 tabanlı) vesize(varsayılan 20, en çok 100) parametreleri kullanılır. - Tüm yanıtlar
traceIdiçerir; hata bildirimlerinde bu değeri iletin.
Ortam farkları özet
Bölüm başlığı “Ortam farkları özet”| Özellik | Staging | Üretim |
|---|---|---|
| Kimlik doğrulama | OIDC Bearer (dev başlığı yedeği) | OIDC (Authorization Code + PKCE) |
| Oran sınırı | Gevşek | Kiracı sözleşmesine göre |
| Veri kalıcılığı | Sıfırlanabilir | Kalıcı, append-only |
| Kura çekilişi | Simüle edilebilir | Resmi, kanıt setli |