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. |
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
extensionsalanında bir sınıflandırma içeren GraphQL hatalarıdır.