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
API-Schlüssel erstellen
Erstellen Sie in Ihrem Konto einen API-Schlüssel. Er wird nur einmal angezeigt, bewahren Sie ihn also sicher auf.
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.Auftrag erteilen
Senden Sie dieselbe Liste mit einem
Idempotency-KeyanPOST /orders. Der Auftrag wird einmal berechnet, egal wie oft Sie ihn senden.Ergebnis abrufen
Fragen Sie
GET /orders/{id}ab, bis der Auftrag abgeschlossen ist, und holen Sie dann die Datei überGET /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 /estimatesundPOST /ordersbis zu 5 Minuten ein: Eine große Liste braucht Zeit zum Einlesen. Bei einem kürzeren Timeout senden Sie die Anfrage umsonst noch einmal.