创建筛选任务

POST /api/openapi/addTask

基于上传文件接口返回的文件路径创建筛选任务。

请求示例

{
    "description": "美国202501..txt",
    "countryCode": "US",
    "countryAreaCode": "1",
    "taskType": "wsExist",
    "fileName": "/profile//2025/09/06/美国202501._20250906180407A028.txt",
    "sourceFileName": "美国202501..txt"
}

参数说明

参数名	类型	必填	说明
description	String	是	原始文件名
countryCode	String	是	国家代码（如：US）
countryAreaCode	String	手机号类必填	区域代码（如：1）。邮箱/用户名类任务可不传
taskType	String	是	筛选类型，见任务类型列表
fileName	String	是	文件路径（由上传接口返回）
sourceFileName	String	是	原始文件名

countryAreaCode 说明

手机号类任务必须传入 countryAreaCode，缺失将直接返回错误「手机号类任务必须传入countryAreaCode（国家区号）」，不会创建任务。

邮箱类任务（email 及所有以 Email 结尾的类型）和 TG 用户名筛活跃（usernameActive）无需传入该参数。

返回示例

{
    "code": 200,
    "msg": "操作成功",
    "data": "TASK-20250119213001-1001"
}

返回说明

• data 字段返回任务 ID（字符串格式）
• 使用返回的 taskId 可以查询任务状态和下载结果