Gửi kiểm tra (Tải tệp)

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.

HTTP 202 Accepted

Tham số

Content-Type: multipart/form-data

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. — Mã quốc gia
file	file	Có	Tệp TXT hoặc CSV, mỗi dòng một số, tối đa 50 MB.

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": "qH5rZ7Lp3Wm9",
  "idempotent_replay": false,
  "message": "File queued (10000 numbers). Poll GET /api/v1/tasks/qH5rZ7Lp3Wm9 for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}

Trường phản hồi

Gửi kiểm tra (Số)