آرڈر دینا
ایک آرڈر ایک فہرست پر ایک چیکر چلاتا ہے۔ ہر چیکر کے لیے مراحل یکساں ہیں۔
1. چیکر منتخب کریں
GET /checkers بتاتا ہے کہ آپ کا اکاؤنٹ کیا آرڈر کر سکتا ہے، آپ کی قیمتوں پر۔ ہر چیکر کا ایک id ہوتا ہے، جیسے whatsapp_status_detection، اور وہ فون نمبرز، ای میلز یا یوزرنیمز لیتا ہے۔ دیکھیں چیکرز۔
curl "https://api.talismanleads.io/v1/checkers" \
-H "Authorization: Bearer tl_live_your_key_here"2. اپنی فہرست بھیجیں
100,000 اندراجات اور 4 MB تک ریکویسٹ میں entries کے طور پر رکھیں۔ بڑی فہرست کے لیے POST /uploads سے لنک مانگیں، اس لنک پر PUT سے فائل بھیجیں، پھر اس کا upload_id استعمال کریں۔ لنک 2 گھنٹے تک چلتا ہے۔ اس پر اپنی API کلید نہ بھیجیں۔
- فائل ایک
.txtہوتی ہے جس میں ہر لائن پر ایک اندراج ہو، 200 MB اور 10,000,000 اندراجات تک۔ - فون نمبرز ملک کے کوڈ کے ساتھ لکھیں، جیسے
+14155550142۔ - ایک فائل کے فون نمبرز ایک ملک کے ہونے چاہئیں: ان میں سے کم از کم 90%۔ ملی جلی فہرست کو ہر ملک کے لیے ایک فائل میں تقسیم کریں۔
- ایک بھی غلط لائن پوری فہرست کو مسترد کر دیتی ہے، اور جواب میں مثالیں دکھائی جاتی ہیں۔
- اپ لوڈ کی گئی فائل آرڈر کے لیے 24 گھنٹے انتظار کرتی ہے، پھر ہٹا دی جاتی ہے۔
- آپ کی 20 فائلیں یا 100 MB ایک ساتھ انتظار میں رہ سکتے ہیں، چاہے آپ کتنی ہی API کیز استعمال کریں، اور آپ دن میں 500 اپ لوڈ کر سکتے ہیں۔ جب آپ ان حدوں سے نیچے ہوں تو کسی بھی اجازت یافتہ سائز کی ایک فائل ان کے اوپر جا سکتی ہے۔
لنک مانگیں
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}'اس پر فائل بھیجیں
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. قیمت دیکھیں
POST /estimates اندراجات گنتا ہے اور قیمت نکالتا ہے، اور کچھ چارج نہیں کرتا۔ billed_entries کی قدر entries سے زیادہ ہو سکتی ہے، کیونکہ ہر فائل کم از کم 2,000 کے حساب سے بل ہوتی ہے۔
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. آرڈر دیں
POST /orders آپ کے بیلنس سے چارج کرتا ہے اور کام کو قطار میں ڈالتا ہے۔ Idempotency-Key بھیجیں، تاکہ دوبارہ کوشش سے آپ سے دو بار چارج نہ ہو سکے: دیکھیں محفوظ دوبارہ کوشش۔ قیمت یقینی بنانے کے لیے expected_charge بھیجیں، اور اگر خرچ اس کے علاوہ کچھ ہو تو آرڈر price_changed کے ساتھ مسترد ہو جاتا ہے۔ جواب کے لیے 5 منٹ تک کا وقت رکھیں، کیونکہ بڑی فہرست پڑھنے میں وقت لگتا ہے۔
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. اسٹیٹس دیکھتے رہیں
ہر 30 سیکنڈ یا اس سے زیادہ کے وقفے پر GET /orders/{id} کو کال کریں۔ بڑی فائل پس منظر میں حصوں میں تقسیم ہوتی ہے، لیکن آرڈر کا ایک ہی اسٹیٹس اور ایک ہی کل ہوتا ہے۔
queued- شروع ہونے کے انتظار میں۔
processing- چل رہا ہے۔
completed- مکمل، ہر حصہ ہو گیا۔
partially_completed- مکمل، کچھ حصے ناکام رہے۔ ان حصوں کا ریفنڈ ہوتا ہے: `refunded` بتاتا ہے کہ کتنا واپس آیا۔
failed- کوئی بھی حصہ نہیں ہو سکا۔ چارج ریفنڈ ہوتا ہے: `refunded` بتاتا ہے کہ کتنا واپس آیا۔
مزید اسٹیٹس شامل ہو سکتے ہیں، اس لیے جس اسٹیٹس کو آپ نہیں جانتے اسے ابھی چلتا ہوا سمجھیں۔
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"6. نتیجہ حاصل کریں
GET /orders/{id}/results ہر حصے کے لیے ڈاؤن لوڈ لنک دیتا ہے، جو 15 منٹ تک کارآمد رہتا ہے۔ نیا لنک کسی بھی وقت دوبارہ مانگیں: نتائج رکھے جاتے ہیں۔ فائل عموماً ایک zip ہوتی ہے جس میں all.csv، ایک اسپریڈشیٹ اور ٹیکسٹ فہرستیں ہوتی ہیں، یا ایک واحد CSV۔ کالم شامل ہو سکتے ہیں، اس لیے انہیں جگہ سے نہیں، نام سے پڑھیں۔ ان لنکس پر اپنی API کلید نہ بھیجیں۔
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"چارج اور ریفنڈ
charge وہ رقم ہے جو آرڈر دیتے وقت اس کی قیمت تھی، اور refunded بتاتا ہے کہ اس میں سے کتنا واپس آیا۔ جو حصہ ناکام ہو اس کا پورا ریفنڈ ہوتا ہے، اور جس حصے کی گنتی پرووائیڈر نے کم کی اس کا فرق واپس کیا جاتا ہے، اس کم از کم تک جس پر وہ حصہ بل ہوتا ہے۔ دونوں خودبخود ہوتے ہیں۔
تقریباً ایک دن کے اندر اسی چیکر پر وہی فہرست، نئی Idempotency-Key کے ساتھ، نئے آرڈر کے طور پر دوبارہ چارج ہوتی ہے، اور نئے چیک کی جگہ آپ کا پچھلا نتیجہ واپس کر سکتی ہے۔
دوسری جگہوں سے دیے گئے آرڈر
ویب سائٹ پر دیے گئے آپ کے آرڈر بھی فہرست میں آتے ہیں۔ API آرڈر ویب سائٹ پر میرے ٹاسکس میں API بیج کے ساتھ نظر آتے ہیں، اور Telegram پر کچھ نہیں بھیجتے جب تک آپ وہاں اس کے لیے نہ کہیں۔