Przejdź do treści

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

  1. Utwórz klucz API

    Utwórz klucz API na swoim koncie. Jest pokazywany tylko raz, więc przechowuj go w bezpiecznym miejscu.

  2. Sprawdź wycenę

    Wyślij listę do POST /estimates, aby zobaczyć cenę i ewentualne problemy z listą. Nie jest pobierana żadna opłata.

  3. Złóż zamówienie

    Wyślij tę samą listę do POST /orders z nagłówkiem Idempotency-Key. Opłata za zamówienie zostanie pobrana raz, niezależnie od tego, ile razy je wyślesz.

  4. Pobierz wynik

    Sprawdzaj GET /orders/{id}, aż zamówienie się zakończy, a następnie pobierz plik z GET /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 /estimates i POST /orders przewidź do 5 minut: odczytanie dużej listy wymaga czasu. Krótszy limit czasu sprawi, że wyślesz żądanie ponownie na próżno.

Na tej stronie