Ошибки и лимиты API

Формат ошибки

Большинство методов возвращает {"error":"Описание ошибки"}. У части ошибок есть дополнительный машинный code.

Что означают статусы

• 400 — неверный JSON, URL, параметры фильтра, даты или превышено число строк в пакетном запросе. Исправьте запрос.
• 401 — ключ отсутствует, неверен, отключён или исчерпан его лимит. Проверьте заголовок Authorization: Bearer … и состояние ключа.
• 403 — функция недоступна на текущем тарифе, например API или свой домен. Повтор запроса не изменит результат.
• 404 — объект не найден или не принадлежит вашему аккаунту. Проверьте ID.
• 429 — превышен лимит операции, например отправки писем. Дождитесь следующего окна лимита.
• 500 — внутренняя ошибка сервиса. Повторяйте с экспоненциальной паузой и ограниченным числом попыток.
• 502 — внешний сервер не принял операцию, например сервер получателя отклонил письмо.

Лимиты

Число использованных и доступных API-запросов показано у каждого ключа в кабинете. Пакетное создание принимает до 1000 ссылок. Аналитика на Free ограничена окном 30 дней.

Идемпотентность

Не повторяйте создание ссылки автоматически после неизвестного результата: первый запрос мог уже сохраниться. Сначала проверьте список ссылок по customCode или целевому URL, чтобы не создать дубль.