Nhà phát triển
Chạy mọi trình kiểm tra từ máy chủ của bạn
API của TalismanLeads làm được những gì trang web làm: gửi danh sách, xem giá, đặt đơn hàng và lấy kết quả. Bạn thanh toán từ cùng một số dư, với cùng mức giá.
Cách hoạt động
Tạo khóa API
Tạo khóa API trong tài khoản của bạn. Khóa chỉ hiển thị một lần, vì vậy hãy lưu ở nơi an toàn.
Báo giá
Gửi danh sách đến
POST /estimatesđể xem giá và mọi vấn đề của danh sách. Không có khoản phí nào bị tính.Đặt đơn hàng
Gửi cùng danh sách đó đến
POST /orderskèmIdempotency-Key. Đơn hàng chỉ bị tính phí một lần, dù bạn gửi bao nhiêu lần.Lấy kết quả
Kiểm tra
GET /orders/{id}cho đến khi hoàn tất, rồi lấy tệp từGET /orders/{id}/results.
Bắt đầu nhanh
Thay khóa bằng khóa API của bạn. Địa chỉ gốc là https://api.talismanleads.io/v1, và yêu cầu cùng phản hồi đều là JSON.
1. Xem chi phí
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. Đặt đơn hàng
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. Kiểm tra trạng thái
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
-H "Authorization: Bearer tl_live_your_key_here"4. Lấy kết quả
curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
-H "Authorization: Bearer tl_live_your_key_here"Cần biết
- Số tiền luôn là chuỗi tính bằng đô la Mỹ, ví dụ
"18.00". - Mỗi tệp được tính phí ít nhất 2.000 mục, trên API cũng như trên trang web.
- Danh sách tối đa 100.000 mục và 4 MB có thể đặt trong yêu cầu. Danh sách lớn hơn, tối đa 10.000.000 mục hoặc 200 MB, đi qua
POST /uploads. - Kiểm tra trạng thái đơn hàng cách nhau từ 30 giây trở lên. Thời gian xử lý đơn hàng tùy thuộc vào kích thước và trình kiểm tra.
- Hãy chờ tối đa 5 phút cho phản hồi từ
POST /estimatesvàPOST /orders: đọc danh sách lớn cần thời gian. Thời gian chờ ngắn hơn sẽ khiến bạn phải gửi lại một cách vô ích.