Zum Inhalt springen

Entwickler

Führen Sie jede Prüfung von Ihrem eigenen Server aus

Die TalismanLeads API kann, was die Website kann: Liste senden, Preis sehen, Auftrag erteilen und Ergebnis abrufen. Sie zahlen aus demselben Guthaben und zu denselben Preisen.

So funktioniert es

  1. API-Schlüssel erstellen

    Erstellen Sie in Ihrem Konto einen API-Schlüssel. Er wird nur einmal angezeigt, bewahren Sie ihn also sicher auf.

  2. Kosten schätzen

    Senden Sie Ihre Liste an POST /estimates, um den Preis und etwaige Probleme mit der Liste zu sehen. Es wird nichts berechnet.

  3. Auftrag erteilen

    Senden Sie dieselbe Liste mit einem Idempotency-Key an POST /orders. Der Auftrag wird einmal berechnet, egal wie oft Sie ihn senden.

  4. Ergebnis abrufen

    Fragen Sie GET /orders/{id} ab, bis der Auftrag abgeschlossen ist, und holen Sie dann die Datei über GET /orders/{id}/results.

Schnellstart

Ersetzen Sie den API-Schlüssel durch Ihren eigenen. Die Basisadresse ist https://api.talismanleads.io/v1, Anfragen und Antworten sind JSON.

1. Sehen, was es kosten würde

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. Auftrag erteilen

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. Status prüfen

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

4. Ergebnis abrufen

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

Gut zu wissen

  • Geldbeträge sind immer ein String in US-Dollar, zum Beispiel "18.00".
  • Jede Datei wird mit mindestens 2.000 Einträgen abgerechnet, über die API wie auf der Website.
  • Eine Liste mit bis zu 100.000 Einträgen und 4 MB kann in der Anfrage stehen. Eine größere, bis zu 10.000.000 Einträge oder 200 MB, läuft über POST /uploads.
  • Fragen Sie den Status eines Auftrags in Abständen von mindestens 30 Sekunden ab. Wie lange ein Auftrag dauert, hängt von seiner Größe und der Prüfung ab.
  • Planen Sie für eine Antwort von POST /estimates und POST /orders bis zu 5 Minuten ein: Eine große Liste braucht Zeit zum Einlesen. Bei einem kürzeren Timeout senden Sie die Anfrage umsonst noch einmal.

Auf dieser Seite