跳转到主要内容
POST
/
task
/
urls:file
更新采集 URLs
curl --request POST \
  --url https://openapi.bazhuayu.com/task/urls:file \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'taskId=<string>' \
  --form file='@example-file'
所需套餐： 旗舰+、企业版、团队版

​
端点

POST https://openapi.bazhuayu.com/task/urls:file

​
描述

将采集的网址替换

​
请求头

参数类型必填说明
AuthorizationString是身份令牌
Content-TypeString是multipart/form-data（需包含 boundary，由客户端自动生成，请勿手动写死）
请求头示例 
{
  "Authorization": "Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6ImdXS3hWc0F4SHhaMDlDcWh6NkNJb3ciLCJ0eXAiOiJhdCtqd3QifQ.eyJuYmYiOjE2MzY0NjIyNzAsImV4cCI6MTYzNjU0ODY2OSwiaXNzIjoiaHR0cDovL3Rlc3QuaWRlbnRpdHkuYmF6aHVheXUuY29tIiwiY2xpZW50X2lkIjoiT2N0b3B1cyIsInN1YiI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImF1dGhfdGltZSI6MTYzNjQ2MjI3MCwiaWRwIjoibG9jYWwiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL25hbWUiOiJ0ZXN0d2VuIiwicHJlZmVycmVkX3VzZXJuYW1lIjoidGVzdHdlbiIsInVuaXF1ZV9uYW1lIjoidGVzdHdlbiIsInJlZ2lzdGVyX2RhdGUiOiIxMS8wNC8yMDE2IDA4OjM4OjE2ICswODowMCIsImxhc3RfbG9naW5fZGF0ZSI6IjA0LzIyLzIwMTkgMDk6MDE6MDIgKzA4OjAwIiwibGFzdF9wYXNzd29yZF9jaGFuZ2VkX2RhdGUiOiIwMS8yMy8yMDE5IDA4OjMwOjMxICswODowMCIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbCI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwic2NvcGUiOlsiZW1haWwiLCJvcGVuaWQiLCJyb2xlcyIsIm9mZmxpbmVfYWNjZXNzIl0sImFtciI6WyJwd2QiXX0.ARhbBfzI1xS6yo-Ue1CFHzMaUIfzw4gJlubNBOkUT4SSTlhuS4bVQ4t4UHuYGbE9VX6XgNVgkcDnx6XapqcPohSy7vPv9TIAsjtbrQSA3mj13SnVVAPWwfAVJ-I7g9HDnyPEEOVSvmZUJhiz-irH5L0ojbnt3ck2rQ9tIFuSd7j2eh5BS4ItjNoHY00rh_QPZltk66a9q-fNE33GrxOaXUdHH47WMlsENnh1gybB7QtGtd6bZ982Qa9JljpFnZWSdEf4VfkN4JmhkUTTC908DqS3stT-LD-9tpztFwB54sd0D4CyOBnESkKrUwjxchYYZo4l1O7auiZVGV48YhZYMw",
  "Content-Type": "multipart/form-data"
}

​
请求体

使用 multipart/form-data 提交表单字段：
参数类型必填说明
taskIdString是任务 Id（表单字段）
fileFile是urls 文件：包含网址列表的文本文件（每行一个 URL）
请求示例 
curl -X POST "https://openapi.bazhuayu.com/task/urls:file" \
  -H "Authorization: Bearer <access_token>" \
  -F "taskId=a3b9bdf7-9aaa-22f6-9ccf-b32790f6df8f" \
  -F "file=@urls.txt"

​
响应

参数类型必填说明
requestIdString是请求Id
dataObject是响应数据
成功示例 
{
  "data": null,
  "requestId": "0HMCVDHG1V3E6:00000002"
}

​
错误响应

参数类型必填说明
requestIdString是请求Id
errorObject是错误信息，参考错误码
codeString是错误码
messageString是错误描述
错误示例 
{
  "error": {
    "code": "InvalidTaskId",
    "message": "无效的任务Id"
  },
  "requestId": "0HMCVDHG1V3E6:00000002"
}