Her API yanıtı bir durum koduyla gelir. Kod, isteğin başarılı olup olmadığını ve başarısızsa sorunun kimde olduğunu söyler. Kodların anlamı RFC 9110 ile tanımlanır. İlk hane sınıfı belirler: 2 başarı, 4 istemci hatası, 5 sunucu hatası.
Entegrasyonda en sık görülen kodlar
| Kod | Anlamı | Pazaryeri bağlamında | Ne yapılır |
|---|---|---|---|
| 200 OK | İstek alındı | Toplu işlemde yalnız "kabul edildi" anlamına gelebilir | Sonucu ayrıca sorgulayın |
| 400 Bad Request | İstek hatalı | Eksik alan, yanlış biçim | Gövdeyi ve alan adlarını kontrol edin |
| 401 Unauthorized | Kimlik doğrulanamadı | Yanlış API Key/Secret, süresi dolmuş belirteç | Bilgileri ve ortamı kontrol edin |
| 403 Forbidden | Yetki yok | Trendyol'da User-Agent eksik; izin verilmeyen işlem | Başlıkları ve izinleri kontrol edin |
| 404 Not Found | Kaynak yok | Yanlış yol, silinmiş ürün | Adresi ve kimliği kontrol edin |
| 409 Conflict | Çakışma | Aynı kaydın ikinci kez oluşturulması | Var olan kaydı kullanın |
| 429 Too Many Requests | İstek sınırı aşıldı | Kısa sürede çok istek | Bekleyip yeniden deneyin |
| 500 Internal Server Error | Sunucu hatası | Platform tarafında beklenmeyen hata | Bir süre sonra tekrar deneyin |
| 503 Service Unavailable | Hizmet geçici olarak yok | Bakım ya da aşırı yük | Bekleyin, tekrar deneyin |
4xx ile 5xx ayrımı neden önemli?
4xx hatasında sorun istektedir; aynı isteği tekrar göndermek sonucu değiştirmez, önce düzeltmek gerekir. 429 bunun istisnasıdır: beklemek yeterlidir. 5xx hatasında ise sorun sunucudadır; bekleyip tekrar denemek çoğu zaman işe yarar. İyi bir entegrasyon bu ayrımı otomatik yapar.
Kod her şeyi söylemez
- Gövdeyi okuyun: Trendyol hata ayrıntısını çoğunlukla gövdedeki errors listesinde verir. Yalnız kod okunursa sebep görünmez.
- 200 de hata olabilir: Toplu işlemlerde öğe bazlı hata sonradan çıkar. GraphQL'de hata 200 yanıtın içindeki errors alanında gelir.
- Aynı kod, farklı neden: Hepsiburada'da katalogda izin verilmeyen bir karakter 500 hatasına yol açabilir; bu durumda tekrar denemek değil, veriyi düzeltmek gerekir.
Platforma özel hata listeleri için Hepsiburada hata kodları sayfasına ve rate limit maddesine bakın.