Gửi kiểm tra (Mảng)

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.

HTTP 202 Accepted

Tham số

Trường	Kiểu	Bắt buộc	Mô tả
product	string	Có	Slug sản phẩm — Danh sách sản phẩm
country	string	Bắt buộc với điện thoại	Sản phẩm điện thoại: mã ISO 3166-1 alpha-2, ví dụ CN hoặc US. Sản phẩm email: bỏ hẳn trường này.
phones	array	Có	Mảng số điện thoại hoặc địa chỉ email từ một nhóm duy nhất.

Ghi chú

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.

Country chỉ dành cho sản phẩm điện thoại

Email không có chiều quốc gia. Gửi country cùng sản phẩm email sẽ không qua được kiểm tra. Đây là quy tắc đối xứng với các endpoint thời gian thực, nơi country là tùy chọn nhưng phải bỏ hẳn với email.

Ví dụ phản hồi

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "idempotent_replay": false,
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

Trường phản hồi

Trường	Kiểu	Mô tả
mode	string	Luôn là async với các lần gửi hàng loạt.
task_id	string	Token dùng để thăm dò và tải xuống. Đây là tham số đường dẫn {token} của các endpoint tác vụ.
idempotent_replay	boolean	true khi lần gửi dùng lại một tác vụ trước đó thay vì tạo tác vụ mới.
recovery_pending	boolean	true khi tác vụ đã vào hàng đợi nhưng phần đối soát vẫn đang được xử lý.
message	string	Bước tiếp theo ở dạng người đọc được.
summary.total	integer	Số dòng được chấp nhận.
summary.cost_deducted	number	Số tiền trừ trước cho lần gửi.

Tiếp theo

• Gửi tệp thay vì mảng
• Thăm dò trạng thái tác vụ cho đến khi hoàn tất