Разработчикам
Запускайте любую проверку со своего сервера
API TalismanLeads делает то же, что и сайт: вы отправляете список, видите цену, размещаете заказ и получаете результат. Оплата идёт с того же баланса и по тем же ценам.
Как это работает
Создайте API-ключ
Создайте API-ключ в своём аккаунте. Он показывается один раз, поэтому храните его в надёжном месте.
Узнайте цену
Отправьте список в
POST /estimates, чтобы увидеть цену и возможные проблемы со списком. Ничего не списывается.Разместите заказ
Отправьте тот же список в
POST /ordersс заголовкомIdempotency-Key. Списание за заказ происходит один раз, сколько бы раз вы его ни отправили.Получите результат
Проверяйте
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: чтение большого списка занимает время. При меньшем тайм-ауте вам придётся отправлять запрос повторно впустую.