任务创建

通过文件或提交json数据进行创建任务

接口URL

POST: {base_url}/openapi/tasks

方式一：通过JSON数据创建任务

1.1 Headers

参数	参数说明
Authorization	Bearer <API令牌>
Content-Type	application/json

1.2 请求参数

参数	类型	必填	参数说明	示例
taskName	String	否	任务名称，若为空则取任务ID
platform	String	是	指定平台，固定传 douyin	douyin
type	String	是	抓取类型，固定传 goods	goods
data	array<string>	是	需批量抓取的商品ID

1.3 请求示例

{
    "platform": "douyin",
    "type": "goods",
    "data": [
        "3765492685130039657",
        "3720261250589000130",
    ]
}

方式二：通过文件创建任务

文件格式支持xlsx, xls, txt，商品ID数据放第一行第一列，多个商品ID换行分隔。
参考如下示例文件。

• test.txt
• test.xlsx

2.1 Headers

参数	参数说明
Authorization	Bearer <API令牌>
Content-Type	multipart/form-data

2.2 请求参数

参数	类型	必填	参数说明	示例
file	File	是	上传的文件	file://C:\Users\19702\Desktop\xxxx.xlsx

2.3 请求示例

curl -X POST '{base_url}/openapi/tasks' \
--header 'Authorization: Bearer <API令牌>' \
--form 'file=@"/Users/19702/Desktop/xxxx.xlsx"'

响应参数

字段	类型	说明
code	Integer	0: 业务正常响应，其他为异常
timestamp	Integer	响应时间戳，单位秒
msg	string	异常信息
data	object	业务数据
├ taskId	string	创建的任务ID
├ fileName	string	提交的任务文件名
├ totalItems	Integer	任务需抓取的商品总数
└ filePath	string	提交的任务文件，下载地址取 base_url 进行拼接，如：${base_url}${filePath}

响应示例

成功

{
    "code": 0,
    "timestamp": 1755079642,
    "data": {
        "taskId": "xxxxx",
        "fileName": "xxxxx.json",
        "totalItems": 1,
        "filePath": "/taskUploads/xxxxx/xxxxx.json"
    }
}

异常数据结构示例

{
    "code": 400,
    "msg": "没有找到需爬取的商品ID",
    "timestamp": 1755074441
}