Перейти к содержимому

Разработчикам

Запускайте любую проверку со своего сервера

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".
  • Каждый файл тарифицируется как минимум за 2000 записей, и в API, и на сайте.
  • Список до 100 000 записей и 4 MB можно передать в запросе. Больший список, до 10 000 000 записей или 200 MB, передаётся через POST /uploads.
  • Проверяйте состояние заказа с интервалом не менее 30 секунд. Время выполнения заказа зависит от его размера и проверки.
  • Закладывайте до 5 минут на ответ от POST /estimates и POST /orders: чтение большого списка занимает время. При меньшем тайм-ауте вам придётся отправлять запрос повторно впустую.

На этой странице