logo
登录

查询监测进度

GET/openapi/v1/geo/runs/{run_id}

需要权限:geo:read

查一轮检测的状态、进度和各平台的执行情况。建议 30 秒轮询一次 —— 一轮以分钟计,更密的轮询拿不到更多信息,只会更快撞上频率限制。
skipped 是正常结果,不是错误
监测跑在真实的 AI 客户端上,某个平台暂时不可用时会被整体跳过,reason 里会写明原因。所以结果里的平台数可能少于你选的,这不是调用出错。

请求参数

路径参数

参数类型说明
run_idstring发起监测时返回的 ID

响应

下列字段位于 data 之下。

字段类型说明
statusstringqueued / running / done / failed / cancelled
progress.doneinteger已完成的格子数(格子 = 意图词 × 平台)
progress.totalinteger总格子数
platforms[].statusstringqueued 未开始 / running 进行中 / done 已完成 / skipped 整个平台本轮不可用
platforms[].failedinteger该平台中失败的格子数。个别失败通常是那条意图词的问题,不代表平台挂了
platforms[].reasonstringskipped 时的原因
sourcestring这一轮从哪个入口发起:api / console / cron

可能的错误

codeHTTP含义与处置
3001404轮次不存在,或不属于你