查询监测进度
GET/openapi/v1/geo/runs/{run_id}
需要权限:geo:read
查一轮检测的状态、进度和各平台的执行情况。建议 30 秒轮询一次 —— 一轮以分钟计,更密的轮询拿不到更多信息,只会更快撞上频率限制。
skipped 是正常结果,不是错误监测跑在真实的 AI 客户端上,某个平台暂时不可用时会被整体跳过,
reason 里会写明原因。所以结果里的平台数可能少于你选的,这不是调用出错。请求参数
路径参数
| 参数 | 类型 | 说明 | |
|---|---|---|---|
| run_id | string | 发起监测时返回的 ID |
响应
下列字段位于 data 之下。
| 字段 | 类型 | 说明 |
|---|---|---|
| status | string | queued / running / done / failed / cancelled |
| progress.done | integer | 已完成的格子数(格子 = 意图词 × 平台) |
| progress.total | integer | 总格子数 |
| platforms[].status | string | queued 未开始 / running 进行中 / done 已完成 / skipped 整个平台本轮不可用 |
| platforms[].failed | integer | 该平台中失败的格子数。个别失败通常是那条意图词的问题,不代表平台挂了 |
| platforms[].reason | string | skipped 时的原因 |
| source | string | 这一轮从哪个入口发起:api / console / cron |
可能的错误
| code | HTTP | 含义与处置 |
|---|---|---|
| 3001 | 404 | 轮次不存在,或不属于你 |
