Hata Kodları ve Sorun Giderme

Standart HTTP hata yapıları, durum kodları kataloğu ve dayanıklılık stratejileri.

Bir istek başarıyla tamamlanamadığında SmallPict, sorunu hızlıca tespit edebilmeniz için standart HTTP durum kodları ve yapılandırılmış JSON nesneleri döndürür.

JSON Hata Formatı

JSON

{  "success": false,  "error": {    "code": "INVALID_IMAGE_PAYLOAD",    "message": "Gönderilen dosya geçerli bir görsel değil veya bozuk.",    "details": {      "mime_type": "text/html",      "expected": [        "image/jpeg",        "image/png",        "image/webp",        "image/avif"      ]    }  }}

HTTP Hata Kodları Tablosu

Kod	Tanımlayıcı	Neden	Çözüm
`400`	`BAD_REQUEST`	Geçersiz JSON sözdizimi veya hatalı parametreler.	JSON yapısını ve alan isimlerini kontrol edin.
`401`	`UNAUTHORIZED`	API anahtarı eksik veya iptal edilmiş.	`X-API-Key` başlığını doğrulayın.
`401`	`TIMESTAMP_DRIFT`	Zaman damgası farkı ±300 saniyeden fazla.	Sunucu saatinizi NTP ile senkronize edin.
`401`	`INVALID_SIGNATURE`	Hesaplanan HMAC-SHA256 imzası eşleşmiyor.	Kanonik metni ve Secret Key'i kontrol edin.
`403`	`FORBIDDEN`	Anahtarın bu işlem için yetkisi bulunmuyor.	Panelden anahtar yetki kapsamını düzenleyin.
`404`	`NOT_FOUND`	Belirtilen görev (`job_id`) veya dosya bulunamadı.	URL'deki kimlik değerini doğrulayın.
`413`	`PAYLOAD_TOO_LARGE`	Dosya, planınızın izin verdiği maksimum boyutu aşıyor.	Yüklemeden önce dosya boyutunu küçültün.
`415`	`UNSUPPORTED_MEDIA`	Desteklenmeyen medya türü.	Yalnızca JPEG, PNG, WebP, AVIF veya SVG gönderin.
`422`	`UNPROCESSABLE`	Uzantı doğru ancak dosya içeriği bozuk.	Yükleme akışının kesilmediğinden emin olun.
`429`	`RATE_LIMIT_EXCEEDED`	Saniye başına istek sınırı aşıldı.	Üstel geri çekilme ile yeniden deneme uygulayın.
`429`	`QUOTA_EXCEEDED`	Aylık dönüşüm kotası tükendi.	Panel üzerinden planınızı yükseltin.
`500`	`INTERNAL_ERROR`	Sunucu kümesinde beklenmeyen arıza.	Kısa bir süre bekledikten sonra isteği yineleyin.
`503`	`SERVICE_UNAVAILABLE`	Bakım çalışması veya geçici aşırı yük.	Geçici olarak passthrough moduna geçiş yapın.