डेवलपर
हर चेकर अपने सर्वर से चलाएँ
TalismanLeads API वही करता है जो वेबसाइट करती है: लिस्ट भेजें, कीमत देखें, ऑर्डर दें और नतीजा लें। भुगतान उसी बैलेंस से होता है, उन्हीं कीमतों पर।
यह कैसे काम करता है
API कुंजी बनाएँ
अपने अकाउंट में API कुंजी बनाएँ। यह एक ही बार दिखाई जाती है, इसलिए इसे किसी सुरक्षित जगह रखें।
अनुमान लें
कीमत और लिस्ट में कोई भी समस्या देखने के लिए अपनी लिस्ट
POST /estimatesपर भेजें। कुछ भी चार्ज नहीं होता।ऑर्डर दें
वही लिस्ट
Idempotency-Keyके साथPOST /ordersपर भेजें। आप इसे कितनी भी बार भेजें, ऑर्डर एक ही बार चार्ज होता है।नतीजा लें
पूरा होने तक
GET /orders/{id}देखते रहें, फिरGET /orders/{id}/resultsसे फ़ाइल लें।
क्विक स्टार्ट
API कुंजी की जगह अपनी कुंजी डालें। बेस एड्रेस https://api.talismanleads.io/v1 है, और रिक्वेस्ट और रिस्पॉन्स JSON में होते हैं।
1. देखें कि कितना खर्च आएगा
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. ऑर्डर दें
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. स्टेटस देखें
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. नतीजा लें
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"ध्यान रखने वाली बातें
- रकम हमेशा अमेरिकी डॉलर में string होती है, जैसे
"18.00"। - हर फ़ाइल कम से कम 2,000 एंट्री के हिसाब से बिल होती है, API पर भी और वेबसाइट पर भी।
- 100,000 एंट्री और 4 MB तक की लिस्ट रिक्वेस्ट में जा सकती है। इससे बड़ी लिस्ट, 10,000,000 एंट्री या 200 MB तक,
POST /uploadsसे जाती है। - ऑर्डर का स्टेटस हर 30 सेकंड या उससे ज़्यादा के अंतर पर देखें। ऑर्डर में कितना समय लगेगा, यह उसके साइज़ और चेकर पर निर्भर करता है।
POST /estimatesऔरPOST /ordersके रिस्पॉन्स के लिए 5 मिनट तक का समय रखें: बड़ी लिस्ट पढ़ने में समय लगता है। इससे छोटा टाइमआउट रखने पर आपको बेवजह दोबारा भेजना पड़ता है।