API hataları ve yeniden denemeler
Yapılandırılmış hata yanıtları, idempotency ve asenkron işlemenin kurtarılması.
Tahmin edilebilir HTTP hataları#
401/403 kimlik doğrulama veya yetkilendirme başarısızlığını gösterir. 404 erişilemeyen nesneleri gizler. 409 değişmez ayarları, zaten kullanılmış yüklemeleri veya geçersiz görev durumunu gösterir. 413 boyut sınırlarını uygular, 422 ayarları doğrular ve 429 oran/eşzamanlılık sınırlaması uygulanıyor.
Geçici ticari hizmet veya kuyruk hataları 503 döndürür. Aynı görev kimliği ve özdeş seçeneklerle işlemeyi yeniden deneyin, üstel geri alma ve sınırlı bir yeniden deneme bütçesi kullanarak.
Kurtarma örneği#
# Safe repeated processing attempt for the SAME task and options
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/process \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"options":{"compression_level":"recommended"}}'Başarısız bir işleme görevi, görevi silmekle tersine çevrilemez. Ödeme tutarsızlıklarını araştırırken hesap kullanımı ve desteğe başvurun.
