Қателер және лимиттер
Қате форматы
{"error": "insufficient_balance", "message": "Недостаточно средств на балансе. Пополните его в кабинете."}
Машиналық error кодына сүйеніңіз. message өрісі — орыс тіліндегі мәтін, ол өзгеруі мүмкін.
| HTTP | error |
Қашан | Не істеу керек |
|---|---|---|---|
| 400 | invalid_json |
Дене JSON емес немесе 4 КБ-тан үлкен | Сұрауды түзету |
| 401 | missing_api_key |
Authorization тақырыбы жоқ |
Кілтті беру |
| 401 | unauthorized |
Кілт табылмады немесе кері қайтарылған | Жаңа кілт шығару |
| 402 | insufficient_balance |
Баланста SMS бағасынан аз қаражат бар | Балансты толықтыру |
| 402 | daily_limit |
Күндік шығын лимиті таусылды | Лимитті көтеру немесе Алматы уақытымен түн ортасын күту |
| 403 | phone_blocked |
Нөмір қара тізіміңізде | Қайталамау |
| 403 | fraud_blocked |
Антифрод бас тартты, себебі reason өрісінде |
Бірден қайталамау |
| 403 | session_required |
Маршрут тек кабинеттен қолжетімді | Әрекетті кабинетте орындау |
| 404 | not_found |
Аккаунтыңызда мұндай нысан жоқ | id мәнін тексеру |
| 422 | invalid_phone |
Қазақстанның ұялы нөмірі емес | Нөмірді түзету |
| 422 | invalid_purpose, invalid_ip, invalid_signals, invalid_options, invalid_metadata |
Код сұрауының өрісі қате | Өрісті түзету |
| 422 | invalid_before |
Үзінді көшірмедегі before RFC 3339 форматында емес |
Параметрді түзету |
| 429 | rate_limited |
Нөмірге арналған сессия лимитінен асты | Пайдаланушыдан күте тұруды сұрау |
| 500 | internal |
Ішкі қате | Сұрауды кейінірек қайталау |
Автоматты түрде тек 500 пен желі қателерін қайталаған жөн. Ескеріңіз: POST /v1/verify идемпотентті емес, егер бірінші сұрау шын мәнінде өтіп кеткен болса, қайталау екінші сессияны жасайды.
Лимиттер және антифрод
Нөмірге арналған сессия лимиті әдепкіде — 72 сағатта 4. Ол тест нөмірлеріне, ақ тізімдегі нөмірлерге және signals.is_trusted_user: true көрсетілген сұрауларға қолданылмайды.
Антифрод ережелері Антифрод бөлімінде бапталады. 0 мәні ережені өшіреді.
reason |
Ереже | Әдепкі мән |
|---|---|---|
ip_rate |
Бір IP-ден сағатына сессиялар | 10 |
device_rate |
Бір құрылғыдан сағатына сессиялар | 5 |
ip_numbers |
Бір IP-ден тәулігіне әртүрлі нөмірлер | 5 |
ip_country |
IP рұқсат етілген елдер тізімінде жоқ елден | Барлығына рұқсат |
ip_blocked |
IP VERYO-ның ортақ блоктізімінде | — |
{"error": "fraud_blocked", "reason": "ip_rate", "message": "Слишком много запросов кода с этого IP за час."}
IP және құрылғы бойынша ережелер signals.ip пен signals.device_id мәндерін берген жағдайда ғана жұмыс істейді.