Hatalar ve limitler

Kararlı hata kodları, retry davranışı ve kullanım politikaları.

Tüm public hatalar status: false, kararlı code, güvenli message ve gerektiğinde details alanlarını kullanır.

Temel hata kodları

HTTP	Code	Davranış
400	`validation_error`	Request alanlarını düzeltin.
401	`missing_api_key`, `invalid_api_key`	Anahtar gönderimini veya durumunu düzeltin.
403	`access_restricted`, `source_scope`	Domain, IP veya kaynak yetkisini kontrol edin.
429	`page_size_limit`, `daily_limit`, `monthly_limit`, `rate_limit_exceeded`	Limite göre trafiği azaltın.
503	`service_unavailable`	Kısa exponential backoff uygulayın.
500	`internal_error`	Sınırlı retry sonrasında destekle iletişime geçin.

Retry politikası

400, 401 ve 403 düzeltilmeden tekrar edilmemelidir. 429 için limit reset davranışına uyun. 503 için jitter içeren sınırlı exponential backoff kullanın. Aynı isteği sonsuz döngüyle tekrarlamayın.

Efektif limit

API key ve kurum politikalarından daha dar olan sınır uygulanır. allowedSources dışındaki kaynak isteği reddedilir; pageSize policy değerinin üzerine çıkamaz.

Karar sınırı

API sonucu aday eşleşmedir. Nihai yaptırım veya uygunluk kararı resmî kaynak doğrulaması ve insan incelemesi gerektirir.