Quy trình thông thường
Gửi một mảng số điện thoại để kiểm tra. Xử lý bất đồng bộ. Chi phí được trừ trước; các số không được kiểm tra sẽ tự động hoàn tiền.
Các endpoint trong một cái nhìn
Phần tiêu đề “Các endpoint trong một cái nhìn”| Endpoint | Mô tả |
|---|---|
GET /v1/balance | Trả về số dư USD hiện tại của tài khoản đã xác thực. |
POST /v1/detect | Gửi một mảng số điện thoại để kiểm tra. Xử lý bất đồng bộ. Chi phí được trừ trước; các số không được kiểm tra sẽ tự động hoàn tiền. |
POST /v1/detect/file | Tải lên tệp TXT hoặc CSV, mỗi dòng một số, tối đa 50 MB. |
GET /v1/tasks/{token} | Kiểm tra định kỳ cho đến khi trạng thái hoàn tất hoặc thất bại. Khoảng cách khuyến nghị: 3–5 giây. |
GET /v1/tasks/{token}/result | Sau khi hoàn tất, lấy URL tải xuống cho tệp kết quả. Mặc định tệp được giữ 7 ngày (do cài đặt hệ thống result_retention_days kiểm soát). |
GET /v1/tasks/{token}/download | Truyền trực tiếp tệp kết quả đã hoàn tất dưới dạng tệp đính kèm. Bạn có thể theo download_url từ endpoint kết quả, hoặc gọi endpoint này với cùng token nhiệm vụ. |
HTTP 202 Accepted
Trước khi gửi
Phần tiêu đề “Trước khi gửi”- Lần gửi phải đạt mức tối thiểu của sản phẩm đã chọn — 500, 1,000 hoặc 2,000 tùy sản phẩm, và được hiển thị trong danh sách sản phẩm hàng loạt — đồng thời không vượt mức tối đa của nền tảng là 2,000,000. Lần gửi dưới mức tối thiểu bị từ chối với
too_few_numbers. - Sản phẩm điện thoại: mã ISO 3166-1 alpha-2, ví dụ
CNhoặcUS. Sản phẩm email: bỏ hẳn trường này. — Mã quốc gia