ДАРА ОТПЕЧАТОКДокументацияОшибки и пределы
Ошибки и пределы
Ошибка API — код HTTP и тело с текстом для человека; решения принимайте по коду. Предел частоты есть только у методов кода страницы.
Ошибка — ответ с кодом HTTP и телом {"success": false, "error": "текст"}. Текст — для человека и может меняться, решения принимайте по коду:
| Код | Когда |
|---|---|
| 400 | нет visitor_uuid или он не UUID, тело не JSON; в /visitor/delete — не ровно одно из полей или почта, телефон не распознаны |
| 401 | ключа нет, он неверный или отозван; публичный ключ в серверном методе |
| 403 | домен страницы не в списке разрешённых доменов сайта |
| 404 | посетителя нет или он принадлежит другому сайту — по 404 на заведомо несуществующий uuid удобно проверять, что ключ действует |
| 429 | слишком часто с одного IP: методы кода страницы (/session/init и старые методы публичного ключа) — 10 запросов в секунду с запасом 40. Серверные методы с секретным ключом частотой не ограничены |
| 500, 503 | сбой на нашей стороне — повторите позже |