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