Chuyển đến nội dung

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

  1. 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.

  2. 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.

  3. Đặt đơn hàng

    Gửi cùng danh sách đó đến POST /orders kèm Idempotency-Key. Đơn hàng chỉ bị tính phí một lần, dù bạn gửi bao nhiêu lần.

  4. 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 /estimates và 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.

Trên trang này