Ошибки
Все отказы имеют одну форму. Ориентируйтесь на code: он никогда не меняется. message предназначено для человека и может меняться.
Форма ошибки
{
"error": {
"code": "insufficient_balance",
"message": "This file costs $18.00 USD but your balance is $4.50 USD. Please add funds.",
"request_id": "req_7f3c9a12",
"docs_url": "https://docs.talismanleads.io/errors#insufficient_balance"
}
}Указывайте request_id, если обращаетесь в поддержку. Каждый ответ также содержит его в заголовке Request-Id.
Все коды
API не понимает этот запрос: причина указана в сообщении. Исправьте его перед повторной отправкой.
POST /orders требует действительный заголовок Idempotency-Key: до 200 символов ASCII без пробелов.Строка списка не соответствует тому, что принимает проверка. В сообщении показаны примеры.
Этой проверке нужно больше записей в файле.
Список слишком длинный: до 100 000 записей в запросе или 10 000 000 в загрузке.
Файл больше 200 MB.
Переданное значение
country не соответствует номерам в списке.Файл должен содержать номера из одной страны. Разделите его на отдельные файлы по странам.
Этот
upload_id не принадлежит вам, его файл ещё не загружен полностью или его файла уже нет (загрузка ждёт заказа 24 часа). Если вы уже заказали по этой загрузке и потеряли ответ, повторите тот запрос с его исходным Idempotency-Key. В противном случае загрузите файл снова и сделайте заказ с новым Idempotency-Key: по старому заказ не размещён.Файл изменился после расчёта цены. Заказ не размещён. Загрузите его снова и сделайте заказ с новым Idempotency-Key.
Цена устарела и не может быть использована. Повторите запрос с тем же
Idempotency-Key.invalid_key
401API-ключ отсутствует, неверен или выдан не нами.
revoked_key
401Этот API-ключ отозван. Используйте другой.
expired_key
401Срок действия этого API-ключа истёк. Создайте новый.
На балансе недостаточно средств для этого заказа. Пополните баланс, затем повторите заказ с тем же Idempotency-Key.
key_blocked
403Этот API-ключ заблокирован. Обратитесь в поддержку.
Этот API-ключ ограничен другими IP-адресами.
Этот аккаунт не может использовать API. Обратитесь в поддержку.
Доступ к API для этого аккаунта отключён. Сайт продолжает работать. Обратитесь в поддержку.
Этот API-ключ только для чтения, а для этого вызова нужен ключ, который может размещать заказы.
Эта проверка сейчас недоступна для вашего аккаунта. См.
GET /checkers.Ваш адрес заблокирован. Обратитесь в поддержку.
not_found
404В этом аккаунте нет такого заказа или эндпоинта.
Этот Idempotency-Key уже использован с другим запросом. Для нового заказа используйте новый Idempotency-Key.
Цена не совпадает с ожидаемой или изменилась с момента первой отправки Idempotency-Key. Заказ не размещён. Используйте новый Idempotency-Key, чтобы заказать по новой цене.
Запрос больше 4 MB. Для большого списка используйте
POST /uploads.У вас слишком много ожидающих загрузок (20 файлов или 100 MB) или сегодня их сделано слишком много (500). Сделайте заказ по одной из них или повторите попытку позже: загрузка удаляется через 24 часа.
rate_limited
429Вы превысили лимит запросов. Подождите столько секунд, сколько указано в
Retry-After. Заказ повторите с тем же Idempotency-Key. См. Лимиты запросов.У вас слишком много незавершённых заказов. Подождите столько секунд, сколько указано в
Retry-After, затем повторите заказ с тем же Idempotency-Key.На нашей стороне что-то пошло не так. При
POST /orders заказ мог пройти, поэтому повторите запрос с тем же Idempotency-Key: двойного списания при этом никогда не будет. При любом другом вызове повторите попытку или обратитесь в поддержку, указав request_id.api_disabled
503API пока отключён. Повторите попытку позже. Заказ повторите с тем же Idempotency-Key.
API сейчас не может ответить. Подождите минуту и повторите запрос с тем же Idempotency-Key.
Нам не удалось подтвердить заказ. Повторите запрос с тем же
Idempotency-Key, чтобы узнать его фактическое состояние: двойного списания при этом никогда не будет. Если этот ответ приходит дольше нескольких минут, остановитесь и обратитесь в поддержку, указав request_id. Не создавайте новый Idempotency-Key.