Перейти до вмісту

Розробникам

Запускайте будь-яку перевірку зі свого сервера

API TalismanLeads робить те саме, що й сайт: ви надсилаєте список, бачите ціну, розміщуєте замовлення й отримуєте результат. Оплата йде з того самого балансу й за тими самими цінами.

Як це працює

  1. Створіть API-ключ

    Створіть API-ключ у своєму акаунті. Він показується один раз, тому зберігайте його в надійному місці.

  2. Дізнайтеся ціну

    Надішліть список у POST /estimates, щоб побачити ціну та можливі проблеми зі списком. Нічого не списується.

  3. Розмістіть замовлення

    Надішліть той самий список у POST /orders із заголовком Idempotency-Key. Списання за замовлення відбувається один раз, скільки б разів ви його не надіслали.

  4. Отримайте результат

    Перевіряйте GET /orders/{id}, доки замовлення не завершиться, потім отримайте файл через GET /orders/{id}/results.

Швидкий старт

Замініть API-ключ на свій. Базова адреса: https://api.talismanleads.io/v1, запити й відповіді у форматі JSON.

1. Дізнайтеся, скільки це коштуватиме

curl -X POST "https://api.talismanleads.io/v1/estimates" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

2. Розмістіть замовлення

curl -X POST "https://api.talismanleads.io/v1/orders" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Idempotency-Key: crm-export-2026-11-05" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

3. Перевірте стан

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

4. Отримайте результат

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

Варто знати

  • Грошові суми завжди передаються рядком у доларах США, наприклад "18.00".
  • Кожен файл тарифікується щонайменше як 2 000 записів, і в API, і на сайті.
  • Список до 100 000 записів і 4 MB можна передати в запиті. Більший список, до 10 000 000 записів або 200 MB, передається через POST /uploads.
  • Перевіряйте стан замовлення з інтервалом не менше 30 секунд. Час виконання замовлення залежить від його розміру та перевірки.
  • Закладайте до 5 хвилин на відповідь від POST /estimates і POST /orders: читання великого списку потребує часу. За коротшого тайм-ауту вам доведеться надсилати запит повторно даремно.

На цій сторінці