Hata Yönetimi
SEO Boost Hub API hata yanıtlarını anlayarak entegrasyonunuzun hatalardan güvenli şekilde toparlanmasını sağlayın.
Hata Yanıt Formatı
Tüm hata yanıtları tutarlı bir JSON yapısını takip eder:
{
"error": {
"code": "resource_not_found",
"message": "The requested location could not be found.",
"details": {
"resource": "location",
"id": "loc_invalid123"
}
}
}
HTTP Durum Kodları
| Durum Kodu | Anlam | Açıklama |
|---|---|---|
400 |
Bad Request | İstek hatalı biçimlendirilmiş veya gerekli alanlar eksik. |
401 |
Unauthorized | Kimlik doğrulama başarısız. API anahtarınızı kontrol edin. |
403 |
Forbidden | API anahtarınız bu işlem için gerekli kapsama sahip değil. |
404 |
Not Found | İstenen kaynak mevcut değil. |
409 |
Conflict | Bir kaynak çakışması oluştu (ör. yinelenen kayıt). |
422 |
Unprocessable Entity | Doğrulama başarısız. Detaylar için errors dizisini kontrol edin. |
429 |
Too Many Requests | Çok fazla istek. Yavaşlayın ve sıfırlama penceresinden sonra tekrar deneyin. |
500 |
Internal Server Error | Beklenmeyen bir sunucu hatası oluştu. Devam ederse destekle iletişime geçin. |
Doğrulama Hataları
422 yanıtı döndürüldüğünde, hata nesnesi alan düzeyinde doğrulama mesajları içeren bir details dizisi içerir:
{
"error": {
"code": "validation_error",
"message": "The given data was invalid.",
"details": {
"name": [
"The name field is required."
],
"city": [
"The city field is required.",
"The city must be a string."
],
"country": [
"The country must be a valid ISO 3166-1 alpha-2 code."
]
}
}
}
Hata Kodları
Aşağıdaki uygulama düzeyinde hata kodları code alanında görünebilir:
| Kod | Açıklama |
|---|---|
authentication_failed |
Kimlik doğrulama bilgileri eksik veya geçersiz |
insufficient_permissions |
İstenen işlem için yetersiz izinler |
resource_not_found |
İstenen kaynak bulunamadı |
resource_conflict |
Kaynak zaten mevcut veya mevcut durumla çakışıyor |
validation_error |
İstek gövdesi doğrulama kurallarını geçemedi |
rate_limit_exceeded |
Mevcut planınız için hız sınırı aşıldı |
internal_error |
Beklenmeyen bir sunucu tarafı hatası oluştu |