API referansı
Hata ve tekrar deneme
Kapsam değişimi, sürüm çakışması ve eksik kanıta doğru tepki verin.
#HTTP durumları
| Durum | Nasıl ele alınır? |
|---|---|
| 400 | İstek biçimi ve zorunlu alanları düzeltin |
| 401 / 403 | Oturumu, yetkiyi, kapsamı ve CSRF/same-origin koşullarını kontrol edin |
| 404 | Kimliği ve seçili kurumdaki erişilebilirliği kontrol edin |
| 409 | Sürüm/kapsam değişimi veya kanıt durumu gibi yanıtın belirttiği çatışmayı çözün |
| 413 | Gönderilen içeriği izin verilen boyutla karşılaştırın |
| 429 / 503 | Yanıtı ve varsa Retry-After değerini değerlendirin; sınırlı bekleme uygulayın |
Her uç nokta bu durumların tümünü üretmez. Hata gövdesinin code/açıklamasını saklamadan önce sır ve kişisel veri içermediğini kontrol edin.
#İyimser eşzamanlılık
Tanım güncelleme istekleri ilgili expectedRevision veya expectedVersion değeriyle çalışır. Çakışmada aynı eski değeri sonsuz tekrar göndermeyin; güncel tanımı okuyun ve değişikliği yeniden değerlendirin. scope_changed durumunda eski ekran kapsamıyla devam etmeyin.
#Tekrar gönderme
İdempotent olduğu belgelenmiş çalışma kimliklerini aynı içerik için koruyun. Karşılaştırmada aynı runId farklı istek için kullanılamaz. SDK teslim makbuzları portal iş isteklerinden farklı protokoldür; belirsiz ağ sonucunu başarı saymayın.
Sigillum Finans · Güncel kaynak sözleşmesi