Xətalar və hədlər
Xətalar tək bir zərf formasında qayıdır; status kodu nə olduğunu deyir. Siyahılar səhifələnir, sorğular sürət həddinə tabedir.
Xəta zərfi
Uğursuz hər cavab eyni formadadır:
{
"success": false,
"message": "Not found",
"error": { "type": "NotFoundError", "code": 404 }
}Başqa şirkətin qeydi mövcud olsa belə 404 qaytarır; qeydin varlığı sızmır. İstemçi xətası (etibarsız sahə, toqquşma) 4xx-dir, serverin daxili təfərrüatı qaytarılmır.
Cavablar
| Kod | Mənası |
|---|---|
| 400 | Sorğu etibarsızdır (pozuq kimlik, çatışmayan və ya səhv sahə) |
| 401 | Açar yoxdur, etibarsızdır, müddəti bitib və ya ləğv edilib |
| 402 | Səviyyənizdəki izləmə hədəfi limiti doldu və ya kredit balansınız çatmır; hədəf əlavə edilmədi |
| 403 | Əhatə kifayət etmir, planda API girişi yoxdur və ya məhsul açıq deyil |
| 404 | Qeyd yoxdur və ya bu açarın şirkətinə aid deyil |
| 408 | Sorğu maksimum cavab müddətini aşdı |
| 409 | Şirkətdə davam edən tarama var; bitməsini gözləyin |
| 429 | Sürət həddi aşıldı; bir dəqiqə sonra yenidən yoxlayın |
| 503 | Threat Investigation müvəqqəti olaraq cavab vermir; avtomatik yenidən sınamayın, bir müddət sonra özünüz yoxlayın |
Sürət limiti
| Sürət limiti | Cavab limitləri |
|---|---|
| Sürət limiti və səhifələmə | 15 dəqiqədə 500 sorğu · IP başına |
| Threat Investigation | 1 dəqiqədə 20 sorğu · firma başına |
Cavab limitləri
| Uc nöqtələr | Səhifə ölçüsü | susmaya görə | maksimum |
|---|---|---|---|
| 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 |
Yenidən cəhd
429 aldığınızda bir müddət gözləyib yenidən cəhd edin. Threat Investigation axtarışlarını avtomatik təkrar ETMƏYİN: kor-koranə təkrarlar dəqiqəlik limiti doldurur.