Yanıtlar ve hatalar

Zarf

Yanıtlar, bir success bayrağı taşıyan JSON’dur.

{ "success": true, "numbers": [] }

Hata durumunda success false olur ve error nedenini açıklar.

{ "success": false, "error": "number zorunludur" }

Hata mesajları kararlı bir arayüz değildir

error, insanın okuması için bir dizedir ve birçok doğrulama hatası için şu an Türkçedir (örneğin number zorunludur, “number zorunlu” demektir). HTTP durum koduna ve "timeout" gibi dokümante edilmiş değerlere göre dallanın, mesaj metnine göre asla.

Durum kodları

Durum	Anlamı
200	İstek işlendi. Bekleme endpoint’lerinde timeout için de kullanılır: gövdeye bakın.
400	Bir parametre eksik ya da hatalı (geçersiz X-Service-Timeout ve derlenemeyen bir regex dahil).
401	X-API-Key header’ı eksik ya da geçersiz.
403	İzin yok; örneğin başka bir projeye ait bir OAuth sonucunu okumak.
404	Adını verdiğiniz şey projeniz için yok (bir numara, bir posta kutusu, bir ek).
499	Yanıt hazır olmadan bağlantıyı kapattınız. Hiçbir şey gönderilmez.
502	Üst sağlayıcı (Twilio, Hero SMS, bir captcha çözücü) başarısız oldu.

Sağlayıcı hataları her zaman HTTP hatası değildir

• Captchas, sağlayıcının kendi yanıtını olduğu gibi döndürür. Bir çözücü captcha’yı çözemediğini bildirdiğinde (örneğin 2Captcha’nın code: "ERROR_..." ya da NoneCap’in status: "failed" değeri), HTTP durumu yine 200’dür. Hatayı sağlayıcıya özgü alanlardan okuyun ya da tipli bir hata fırlatan SDK’yı kullanın.
• Toplu kiralamalar (Twilio’da phone_numbers, Hero SMS’te quantity) numara başına sonuçla birlikte 200 döner. Bir numaranın başarısız olması isteği başarısız yapmaz; her kaydın success alanına bakın.

Yeniden deneme

API sizin yerinize yeniden denemez, SDK’lar da denemez. Numara kiralamak para harcar; bu yüzden bir rent çağrısındaki 502’yi yeniden denemeden önce GET /numbers/list’i kontrol edin. Beklemeleri tekrarlamak güvenlidir.