提交文件检测

POST/v1/detect/file

上传 TXT 或 CSV 文件，每行一个电话号码或邮箱地址，最大 50 MB。文件会作为任务入队，轮询方式与数组提交完全相同。

返回 HTTP 202 Accepted。

请求参数

Content-Type：multipart/form-data

字段	类型	必填	说明
product	string	是	产品 slug，见批量产品列表。
country	string	电话类产品必填	ISO 3166-1 二位国家码——完整列表见国家代码列表。邮件类产品请省略该字段。
file	file	是	TXT 或 CSV 文件，每行一条号码或邮箱，最大 50 MB。

数量规则与数组提交一致：至少达到所选产品的最小提交量，最多 2,000,000 行。若文件中所有行都解析失败，请求会被拒绝并返回 empty_input。

响应示例

{
  "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
  }
}

响应体结构与数组提交完全一致——只有 message 不同，因为行数来自文件而不是 JSON 数组。