跳转到主要内容
POST
/
taskanalytics
/
queries
cURL
curl -X POST "https://openapi.bazhuayu.com/taskanalytics/queries" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"start":"","end":"","page":null,"pageSize":null,"taskIds":[],"memberNames":[],"collectionMethod":"","timeGranularity":""}'
所需套餐： 旗舰版、旗舰+、企业版

​
端点

POST https://openapi.bazhuayu.com/taskanalytics/queries

​
描述

按日/周/月粒度查询任务采集量、执行次数、成功率及资源消耗等指标。时间范围为 UTC 自然日，仅支持查询最近 3 个月内数据。 未传 memberNames 或传空数组时，仅查询当前登录用户；传入成员名称时须为当前用户团队成员。 选填字段未填写时应为空值（如 ""、[]、null），不要使用 <string>、123 等自动生成的占位值。

​
请求头

参数类型必填说明
AuthorizationString是身份令牌
Content-TypeString是application/json
请求头示例 
{
  "Authorization": "Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6ImdXS3hWc0F4SHhaMDlDcWh6NkNJb3ciLCJ0eXAiOiJhdCtqd3QifQ.eyJuYmYiOjE2MzY0NjIyNzAsImV4cCI6MTYzNjU0ODY2OSwiaXNzIjoiaHR0cDovL3Rlc3QuaWRlbnRpdHkuYmF6aHVheXUuY29tIiwiY2xpZW50X2lkIjoiT2N0b3B1cyIsInN1YiI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImF1dGhfdGltZSI6MTYzNjQ2MjI3MCwiaWRwIjoibG9jYWwiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL25hbWUiOiJ0ZXN0d2VuIiwicHJlZmVycmVkX3VzZXJuYW1lIjoidGVzdHdlbiIsInVuaXF1ZV9uYW1lIjoidGVzdHdlbiIsInJlZ2lzdGVyX2RhdGUiOiIxMS8wNC8yMDE2IDA4OjM4OjE2ICswODowMCIsImxhc3RfbG9naW5fZGF0ZSI6IjA0LzIyLzIwMTkgMDk6MDE6MDIgKzA4OjAwIiwibGFzdF9wYXNzd29yZF9jaGFuZ2VkX2RhdGUiOiIwMS8yMy8yMDE5IDA4OjMwOjMxICswODowMCIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbCI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwic2NvcGUiOlsiZW1haWwiLCJvcGVuaWQiLCJyb2xlcyIsIm9mZmxpbmVfYWNjZXNzIl0sImFtciI6WyJwd2QiXX0.ARhbBfzI1xS6yo-Ue1CFHzMaUIfzw4gJlubNBOkUT4SSTlhuS4bVQ4t4UHuYGbE9VX6XgNVgkcDnx6XapqcPohSy7vPv9TIAsjtbrQSA3mj13SnVVAPWwfAVJ-I7g9HDnyPEEOVSvmZUJhiz-irH5L0ojbnt3ck2rQ9tIFuSd7j2eh5BS4ItjNoHY00rh_QPZltk66a9q-fNE33GrxOaXUdHH47WMlsENnh1gybB7QtGtd6bZ982Qa9JljpFnZWSdEf4VfkN4JmhkUTTC908DqS3stT-LD-9tpztFwB54sd0D4CyOBnESkKrUwjxchYYZo4l1O7auiZVGV48YhZYMw",
  "Content-Type": "application/json"
}

​
请求体

参数类型必填说明
startString是查询开始日期（含），格式 yyyy-MM-dd，如 2026-02-01
endString是查询结束日期（含），格式 yyyy-MM-dd；不得晚于当前 UTC 日期，且不能早于 start
pageNumber选填页码，≥1，默认 1
pageSizeNumber选填每页条数，1～500，默认 20
taskIdsString[]选填任务 Id 列表，最多 100 个；不传表示不过滤任务
memberNamesString[]选填团队成员名称，最多 100 个；不传或空数组表示仅查当前用户
collectionMethodString选填采集方式：Cloud / Local / All；不传或 All 表示不过滤
timeGranularityString选填时间粒度：Day / Week / Month，默认 Day
请求体示例（仅必填参数） 
{
  "start": "2026-02-01",
  "end": "2026-04-01"
}
请求体示例（含选填参数） 
{
  "start": "2026-02-01",
  "end": "2026-04-01",
  "page": 1,
  "pageSize": 20,
  "timeGranularity": "Week",
  "collectionMethod": "All",
  "taskIds": [
    "task-id-1"
  ],
  "memberNames": []
}

​
响应

参数类型必填说明
dataObject是响应数据
totalNumber是符合条件的总记录数（用于分页）
dataObject[]是当前页数据列表
taskIdString是任务 Id
userIdString是用户 Id
taskNameString否任务名称（可能为 null）
dayKeyString是时间分桶键（日：yyyy-MM-dd；周：YYYY-WW；月：yyyy-MM）
weekStartDateString否周开始日期 yyyy-MM-dd，仅 Week 粒度有值
weekEndDateString否周结束日期 yyyy-MM-dd，仅 Week 粒度有值
collectionMethodString是采集方式：Cloud / Local
dataVolumeMetricsObject是数据量指标
totalCollectedNumber否采集总量；无数据为 null
deduplicatedVolumeNumber否去重后保存量；无数据为 null
executionMetricsObject是执行指标
runCountNumber否运行次数
successCountNumber否成功次数
failureCountNumber否失败次数
durationPerRunSecondsNumber否单次平均耗时（秒）
totalExecutionSecondsNumber否总耗时（秒）
successRateNumber否成功率，0～1
failureRateNumber否失败率，0～1
resourceUsageMetricsObject是资源消耗指标
captchaCountNumber否验证码次数
simpleTemplateCountNumber否简易模板条数
proxyIpCountNumber否代理 IP 用量
balanceNumber否资源消耗金额
requestIdString是请求 Id
成功示例 
{
  "data": {
    "total": 42,
    "data": [
      {
        "taskId": "abc123",
        "userId": "user001",
        "taskName": null,
        "dayKey": "2026-11",
        "weekStartDate": "2026-03-10",
        "weekEndDate": "2026-03-16",
        "collectionMethod": "Cloud",
        "dataVolumeMetrics": {
          "totalCollected": 10000,
          "deduplicatedVolume": 8000
        },
        "executionMetrics": {
          "runCount": 50,
          "successCount": 48,
          "failureCount": 2,
          "durationPerRunSeconds": 12.5,
          "totalExecutionSeconds": 625,
          "successRate": 0.96,
          "failureRate": 0.04
        },
        "resourceUsageMetrics": {
          "captchaCount": 10,
          "simpleTemplateCount": null,
          "proxyIpCount": 1.5,
          "balance": 3.2
        }
      }
    ]
  },
  "requestId": "0HMD469L0I8Q1:00000001"
}

​
错误响应

参数类型必填说明
requestIdString是请求Id
errorObject是错误信息，参考错误码
codeString是错误码
messageString是错误描述
错误示例 
{
  "error": {
    "code": "MemberNotAllowed",
    "message": "存在无权查询的成员名称"
  },
  "requestId": "0HMD469L0I8R0:00000001"
}

授权

​
Authorization
string
header
必填

身份令牌

请求头

​
Authorization
string
必填

身份令牌，格式 Bearer {access_token}

示例:

"Bearer <access_token>"

​
Content-Type
string
默认值:application/json
必填

application/json

示例:

"application/json"

请求体

application/json
​
start
string
必填

查询开始日期（含），格式 yyyy-MM-dd

​
end
string
必填

查询结束日期（含），格式 yyyy-MM-dd

​
page
integer

页码，≥1，默认 1

​
pageSize
integer

每页条数，1～500，默认 20

​
taskIds
string[]

任务 Id 列表，最多 100 个

​
memberNames
string[]

团队成员名称，最多 100 个

​
collectionMethod
string

采集方式：Cloud / Local / All

​
timeGranularity
string

时间粒度：Day / Week / Month

响应

200

成功