Помилки
Усі відмови мають одну форму. Орієнтуйтеся на 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.