Hatalar ve sınırlar

Hatalar tek bir zarf biçiminde döner; durum kodu ne olduğunu anlatır. Listeler sayfalanır, istekler hız sınırına tabidir.

Hata zarfı

Başarısız her yanıt aynı biçimdedir:

{
  "success": false,
  "message": "Not found",
  "error": { "type": "NotFoundError", "code": 404 }
}

Başka bir firmanın kaydı, var olsa bile 404 döner; kaydın varlığı sızmaz. İstemci hatası (geçersiz alan, çakışma) 4xx’tir, sunucunun iç ayrıntısı dönmez.

Yanıtlar

Kod	Anlamı
400	İstek geçersiz (bozuk kimlik, eksik ya da hatalı alan)
401	Anahtar yok, geçersiz, süresi dolmuş ya da iptal edilmiş
402	Kademenizdeki izleme hedefi sınırı doldu ya da kredi bakiyeniz yetmiyor; hedef eklenmedi
403	Kapsam yetersiz, planda API erişimi yok ya da ürün açık değil
404	Kayıt yok ya da bu anahtarın firmasına ait değil
408	İstek azami yanıt süresini aştı
409	Firmada yürüyen bir tarama var; bitmesini bekleyin
429	Hız sınırı aşıldı; bir dakika sonra tekrar deneyin
503	Threat Investigation geçici olarak yanıt vermiyor; otomatik yeniden denemeyin, bir süre sonra kendiniz deneyin

Hız sınırı

Hız sınırı	Yanıt sınırları
Hız sınırı ve sayfalama	15 dakikada 500 istek · IP başına
Threat Investigation	1 dakikada 20 istek · firma başına

Yanıt sınırları

Uçlar	Sayfa boyutu	varsayılan	en çok
GET /v1/leaks	limit	50	100
GET /v1/leaks/{reportId}/credentials	limit	50	100
GET /v1/leak-events	limit	50	100
GET /v1/scans	limit	50	100
GET /v1/scans/{scanId}/findings	limit	50	100
GET /v1/inventory	limit	50	100
GET /v1/analyses	limit	25	100
GET /v1/protection-resources	limit	50	100
GET /v1/requests	limit	50	100
GET /v1/webhooks/{groupId}/deliveries	limit	100	100
GET /v1/watch/assets	pageSize	20	200
GET /v1/watch/findings	pageSize	20	200
GET /v1/hunter/search	limit	50	200
GET /v1/hunter/audit	limit	100	500
GET /v1/hunter/targets	pageSize	50	200
GET /v1/hunter/findings	pageSize	50	200

Yeniden deneme

429 aldığınızda bir süre bekleyip tekrar deneyin. Threat Investigation aramalarını otomatik yeniden DENEMEYİN: körlemesine tekrar dakikalık sınırı doldurur.