การสั่งซื้อ
คำสั่งซื้อหนึ่งรายการรันตัวตรวจสอบหนึ่งตัวกับรายชื่อหนึ่งชุด ขั้นตอนเหมือนกันสำหรับตัวตรวจสอบทุกตัว
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. ติดตามสถานะ
เรียก GET /orders/{id} ทุก 30 วินาทีหรือนานกว่านั้น ไฟล์ขนาดใหญ่จะถูกแบ่งเป็นหลายส่วนอยู่เบื้องหลัง แต่คำสั่งซื้อมีสถานะเดียวและยอดรวมเดียว
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 ใหม่ จะถูกเรียกเก็บเงินอีกครั้งเป็นคำสั่งซื้อใหม่ และอาจคืนผลลัพธ์เดิมของคุณแทนการตรวจสอบใหม่
คำสั่งซื้อจากที่อื่น
คำสั่งซื้อที่คุณทำบนเว็บไซต์จะแสดงด้วย คำสั่งซื้อจาก API จะปรากฏในงานของฉันบนเว็บไซต์พร้อมป้าย API และจะไม่ส่งอะไรไปยัง Telegram เว้นแต่คุณจะขอใน Telegram