Dla programistów
Uruchamiaj każdy weryfikator ze swojego serwera
API TalismanLeads robi to samo co strona: wysyłasz listę, widzisz cenę, składasz zamówienie i pobierasz wynik. Płacisz z tego samego salda, według tych samych cen.
Jak to działa
Utwórz klucz API
Utwórz klucz API na swoim koncie. Jest pokazywany tylko raz, więc przechowuj go w bezpiecznym miejscu.
Sprawdź wycenę
Wyślij listę do
POST /estimates, aby zobaczyć cenę i ewentualne problemy z listą. Nie jest pobierana żadna opłata.Złóż zamówienie
Wyślij tę samą listę do
POST /ordersz nagłówkiemIdempotency-Key. Opłata za zamówienie zostanie pobrana raz, niezależnie od tego, ile razy je wyślesz.Pobierz wynik
Sprawdzaj
GET /orders/{id}, aż zamówienie się zakończy, a następnie pobierz plik zGET /orders/{id}/results.
Szybki start
Zastąp klucz API swoim własnym. Adres bazowy to https://api.talismanleads.io/v1, a żądania i odpowiedzi są w formacie JSON.
1. Zobacz, ile to będzie kosztować
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. Złóż zamówienie
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. Sprawdź stan
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. Pobierz wynik
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"Warto wiedzieć
- Kwoty są zawsze ciągiem znaków w dolarach amerykańskich, na przykład
"18.00". - Każdy plik jest rozliczany jak za co najmniej 2000 wpisów, w API tak samo jak na stronie.
- Lista do 100 000 wpisów i 4 MB może znaleźć się w żądaniu. Większa, do 10 000 000 wpisów lub 200 MB, przechodzi przez
POST /uploads. - Sprawdzaj stan zamówienia w odstępach co najmniej 30 sekund. Czas trwania zamówienia zależy od jego wielkości i weryfikatora.
- Na odpowiedź z
POST /estimatesiPOST /ordersprzewidź do 5 minut: odczytanie dużej listy wymaga czasu. Krótszy limit czasu sprawi, że wyślesz żądanie ponownie na próżno.