Ana sayfaLojistik sağlayıcıları için API hataları

API hataları

Zonos GraphQL API tarafından döndürülen hataları anlayın ve çözün.

GraphQL

Zonos API iki tür hata döndürür: aktarım seviyesi hatalarına karşılık gelen HTTP durum kodları ve uygulama seviyesi sorunlarına karşılık gelen GraphQL hataları. Çoğu hata, nedenin ve uygun çözümün belirlenmesine yardımcı olmak için extensions alanında bir sınıflandırma içeren GraphQL hatalarıdır.

HTTP durum kodları

HTTP hataları, bir isteğin aktarım seviyesinde işlenemiyor olması durumunda döndürülür.

Durum kodu↕	Anlamı↕
400	Geçersiz bağımsız değişken / kötü istek — istek geçersiz giriş içerir.
401	Yetkisiz — geçerli kimlik bilgileri sağlanmadı.
404	Bulunamadı — istenen kaynak mevcut değildir.
409	Kaynak çatışması — istek bir kaynağın mevcut durumuyla çatışır.
412	Ön koşul başarısız — işlemden önce gerekli bir koşul karşılanmadı.
422	İşlenemeyen varlık — istek gövdesi yapısal olarak geçerli ancak geçersiz değerler içerir.
429	Hız sınırı — kısa bir süre içinde çok fazla istek. Üstel geri çekilme kullanın ve yeniden deneyin.
500	İç sunucu hatası — beklenmeyen bir sunucu tarafı hatası oluştu. Yeniden deneyin; devam ederse destekle iletişime geçin.
503	Hizmet kullanılamıyor — hizmet geçici olarak çevrimdışıdır. Kısa bir gecikmeden sonra yeniden deneyin.
504	Zaman aşımı — sunucu zamanında yanıt almadı. İsteği yeniden deneyin.

GraphQL hata biçimi

Uygulama seviyesi hataları, yanıt gövdesinin errors alanında bir liste olarak döndürülür. Her hata bir message, başarısız olan işlemin path ve hata türü ile istek kimliğini içeren bir extensions nesnesi içerir.

1{

2 "errors": [

3 {

4 "message": "Description of the error",

5 "path": [

6 "landedCostCalculate"

7 ],

8 "extensions": {

9 "errorType": "BAD_REQUEST",

10 "requestId": "req_abc123"

11 }

12 }

13 ]

14}

Hata sınıflandırmaları

extensions.errorType alanı, hatanın kategorisini ve önerilen eylemi gösterir.

Sınıflandırma↕	HTTP eşdeğeri↕	Anlamı↕	İşlem↕
`BAD_REQUEST`	400	Geçersiz giriş veya istek parametreleri.	İsteği düzeltin — gerekli alanları, biçimleri ve değerleri kontrol edin.
`NOT_FOUND`	404	Başvurulan bir kaynak mevcut değildir.	Kimlikleri, kodları doğrulayın ve gerekli varsayılanların yapılandırıldığını doğrulayın.
`UNAVAILABLE`	503	İstenen hizmet veya seçenek bu rota için kullanılamıyor.	Farklı bir yöntem, hizmet seviyesi veya hedef deneyin.
`PERMISSION_DENIED`	401 / 403	Kimlik doğrulama veya yetkilendirme hatası.	Kimlik bilgilerini ve hesap izinlerini kontrol edin.
`FAILED_PRECONDITION`	412	Gerekli bir yapılandırma veya kurulum koşulu karşılanmadı.	Kuruluş ayarlarını kontrol edin veya destekle iletişime geçin.
`INTERNAL`	500	Beklenmeyen bir sunucu tarafı hatası oluştu.	İsteği yeniden deneyin; sorun devam ederse destekle iletişime geçin.
`UNKNOWN`	500	Başka bir sınıflandırması olmayan beklenmeyen bir hata.	İstek biçimini doğrulayın; sorun devam ederse destekle iletişime geçin.

Demo rezervasyonu yap

API hataları

HTTP durum kodları

GraphQL hata biçimi

Hata sınıflandırmaları

Bu sayfa faydalı mıydı?