Güvenilirlik
Idempotency, hız limitleri ve yeniden deneme davranışı.
Idempotency
TurkeySMS API, istemci yeniden denemeleri ve ağ kesintileri sırasında yanlışlıkla çift gönderimi azaltmak için tasarlanmış bir tekrar koruması içerir. Sistem her gönderim isteğinin deterministik bir parmak izini sunucu tarafında hesaplar; kısa bir pencere içinde tekrarlanan aynı istek tespit edilir ve ikinci bir gönderim üretmez.
Bu, ağ zaman aşımları ve yeniden denemelere karşı pratik bir güvencedir; dağıtık sistem düzeyinde mutlak bir garanti olarak sunulmaz. Yine de yanlışlıkla tekrarlanan bir isteğin çift SMS veya çift ücrete dönüşme riskini önemli ölçüde azaltır.
Hız limitleri
API anahtarları dakika başına bir istek limitine tabidir. Limit aşıldığında istek TS-1060 (HTTP 403) ile reddedilir. Yüksek hacimli gönderim için toplu uç noktalarını (/group/send, /group/sendMixed) kullanın.
Yeniden deneme rehberi
Idempotency koruması sayesinde başarısız isteklerin yeniden denenmesi güvenlidir. Yine de yalnızca geçici hatalarda yeniden deneyin:
| Durum | Yeniden dene? |
|---|---|
| Ağ zaman aşımı / bağlantı hatası | Evet — backoff ile |
| HTTP 5xx | Evet — backoff ile |
| Hız limiti (TS-1060) | Evet — bekledikten sonra |
| Geçersiz API anahtarı (TS-1031) | Hayır |
| Bakiye yetersiz (TS-1027) | Hayır |
| İzin yetersiz (TS-1065) | Hayır |