Hata kodları
AIDE API tüm hataları aynı zarfta döner: code + insan dostu mesaj + zorunlu request_id.
INVALID_URLHTTP 400When
URL şeması veya hostname geçersiz (eksik scheme, javascript:, vb.)
How to fix
https:// ile başlayan, en az bir nokta içeren bir hostname kullanın.
SSRF_BLOCKEDHTTP 400When
URL özel ağ, loopback veya kara liste üzerine çözümlendi.
How to fix
Yalnızca public DNS adı + public IP üzerinden erişilebilen URL gönderin.
NOT_FOUNDHTTP 404When
Belirtilen scan_id veya kaynak bulunamadı.
How to fix
GET /v1/scans listesinden hâlâ var olan bir id seçin.
UNAUTHORIZEDHTTP 401When
Authorization header eksik ya da hatalı.
How to fix
Authorization: Bearer aide_… header'ı ile gönderin.
FORBIDDENHTTP 403When
Anahtarın bu kaynağa erişim hakkı yok (paylaşımlı kaynak, izin reddi).
How to fix
Sahibi olduğunuz veya paylaşılan kaynaklara erişin.
RATE_LIMITEDHTTP 429When
Saniye/saat kotanız aşıldı.
How to fix
Retry-After header'ında belirtilen süre kadar bekleyin.
QUOTA_EXCEEDEDHTTP 429When
Aylık plan kotanızı tükettiniz.
How to fix
Plan yükseltin veya bir sonraki billing cycle'ı bekleyin.
VALIDATION_ERRORHTTP 422When
İstek gövdesi şemayla eşleşmiyor (extra alan, yanlış tip).
How to fix
API referansındaki şemaya göre gövdenizi düzeltin.
INTERNALHTTP 500When
Sunucu tarafında beklenmeyen bir hata.
How to fix
request_id'yi destekle paylaşın.