上传文件
POST /api/openapi/upload
上传待筛选的号码文件,返回文件路径与预估费用,供创建任务使用。
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| file | form-data | File | 是 | 仅 .txt,≤ 1 GB,≤ 100 万行 |
| taskType | form-data | String | 是 | 业务类型,见任务类型列表 |
| countryCode | form-data | String | 否 | 国家代码(如:US),用于国家过滤 |
返回示例
{
"code": 200,
"msg": "操作成功",
"data": {
"unitPrice": 0.000050,
"name": "美国202501..txt",
"taskTotal": 1197,
"estimatedCost": 0.059850,
"fileName": "/profile//2025/09/06/美国202501._20250906180407A028.txt",
"errorMsg": null
}
}
data 即为创建任务所需要的参数。
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| unitPrice | Decimal | 单价 |
| name | String | 原始文件名 |
| taskTotal | Integer | 解析出的数据总量 |
| estimatedCost | Decimal | 预估费用(unitPrice × taskTotal) |
| fileName | String | 服务端文件路径(创建任务时传入) |
| errorMsg | String | 错误信息(成功时为 null) |