Składanie zamówień

1. Wybierz weryfikatorCopy Anchor Link

GET /checkers pokazuje, co może zamówić Twoje konto, według Twoich cen. Każdy weryfikator ma id, na przykład whatsapp_status_detection, i przyjmuje telefony, adresy e-mail lub nazwy użytkowników. Zobacz Weryfikatory.

curl "https://api.talismanleads.io/v1/checkers" \
  -H "Authorization: Bearer tl_live_your_key_here"

2. Wyślij listęCopy Anchor Link

Umieść do 100 000 wpisów i 4 MB w żądaniu jako entries. Dla większej listy poproś POST /uploads o link, wyślij plik na ten link metodą PUT, a następnie użyj jego upload_id. Link jest ważny 2 godziny. Nie wysyłaj na niego swojego klucza API.

• Plik to .txt z jednym wpisem w każdym wierszu, do 200 MB i 10 000 000 wpisów.
• Numery telefonów zapisuj z kodem kraju, na przykład +14155550142.
• Numery telefonów w jednym pliku powinny pochodzić z jednego kraju: co najmniej 90% z nich. Podziel mieszaną listę na osobne pliki dla każdego kraju.
• Jeden nieprawidłowy wiersz powoduje odrzucenie całej listy, a odpowiedź pokazuje przykłady.
• Przesłany plik czeka na zamówienie 24 godziny, a następnie jest usuwany.
• Jednocześnie może czekać 20 plików lub 100 MB, niezależnie od liczby używanych kluczy API, a dziennie możesz wykonać 500 przesłań. Gdy jesteś poniżej tych limitów, może dodatkowo dojść jeden plik o dowolnym dozwolonym rozmiarze.

Poproś o link

curl -X POST "https://api.talismanleads.io/v1/uploads" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_name":"list.txt","size_bytes":1048576}'

Wyślij na niego plik

UPLOAD_URL="PASTE_upload_url_FROM_THE_ANSWER_ABOVE"
curl --upload-file list.txt "$UPLOAD_URL" \
  -H "Content-Type: text/plain" \
  -w "%{http_code}\n"

3. Zobacz cenęCopy Anchor Link

POST /estimates liczy wpisy i oblicza cenę, nie pobierając żadnej opłaty. billed_entries może być większe niż entries, ponieważ każdy plik jest rozliczany jak za co najmniej 2000.

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"]}'

4. Złóż zamówienieCopy Anchor Link

POST /orders obciąża Twoje saldo i ustawia pracę w kolejce. Wyślij Idempotency-Key, aby ponowienie nie mogło obciążyć Cię dwa razy: zobacz Bezpieczne ponawianie. Aby mieć pewność co do ceny, wyślij expected_charge, a zamówienie zostanie odrzucone z kodem price_changed, jeśli kosztuje cokolwiek innego. Na odpowiedź przewidź do 5 minut, ponieważ odczytanie dużej listy wymaga czasu.

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"]}'

5. Śledź stanCopy Anchor Link

Odpytuj GET /orders/{id} w odstępach co najmniej 30 sekund. Duży plik jest w tle dzielony na części, ale zamówienie ma jeden stan i jedną sumę.

queued

Czeka na rozpoczęcie.

processing

W toku.

completed

Zakończone, wszystkie części wykonane.

partially_completed

Zakończone, niektóre części się nie powiodły. Opłata za te części jest zwracana: `refunded` pokazuje, ile wróciło.

failed

Nie udało się wykonać żadnej części. Opłata jest zwracana: `refunded` pokazuje, ile wróciło.

Mogą pojawić się kolejne stany, więc nieznany stan traktuj jako wciąż trwający.

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

6. Pobierz wynikCopy Anchor Link

GET /orders/{id}/results zwraca link do pobrania dla każdej części, ważny 15 minut. O nowy link możesz poprosić w dowolnej chwili: wyniki są przechowywane. Plik to zwykle archiwum zip zawierające all.csv, arkusz kalkulacyjny i listy tekstowe albo pojedynczy plik CSV. Kolumny mogą zostać dodane, więc odczytuj je po nazwie, a nie po pozycji. Nie wysyłaj na te linki swojego klucza API.

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

Opłaty i zwrotyCopy Anchor Link

charge to koszt zamówienia w chwili złożenia, a refunded to część tej kwoty, która wróciła. Część, która się nie powiodła, jest zwracana w całości, a za część, którą dostawca policzył jako mniejszą, zwracana jest różnica, aż do minimum, według którego ta część jest rozliczana. Oba zwroty są automatyczne.

Za tę samą listę w tym samym weryfikatorze w ciągu około doby, pod nowym kluczem Idempotency-Key, opłata jest pobierana ponownie jak za nowe zamówienie, a zamówienie może zwrócić Twój wcześniejszy wynik zamiast nowej weryfikacji.

Zamówienia z innych miejscCopy Anchor Link

Zamówienia złożone na stronie też są na liście. Zamówienia z API pojawiają się na stronie w sekcji Moje zadania z plakietką API i nie wysyłają niczego do Telegrama, chyba że tam o to poprosisz.