更新时间:2026-07-13 GMT+08:00
分享

预测结果查询

功能介绍

根据item列表查询预测的时序数据结果。

URI

POST /v1/predictions

获取URI方式请参见请求URI

请求参数

表1 请求Header参数(Token认证)

参数

是否必选

参数类型

描述

X-Auth-Token

是(云上部署模型填写)

String

参数解释:

用户Token。

用于获取操作API的权限。图4响应消息头中X-Subject-Token的值即为Token。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

表2 请求Header参数(API Key认证)

参数

是否必选

参数类型

描述

X-Apig-AppCode

是(云上部署模型填写、边缘部署模型仅在监控网关访问模式下填写)

String

参数解释:

API Key值。

用于获取操作API的权限。API Key认证响应消息头中X-Apig-AppCode的值即为API Key。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

表3 请求Body参数

参数

参数类型

描述

items

List[String]

参数解释:

需要查询的item列表。

约束限制:

不涉及

取值范围:

列表元素在可查询的item列表中(参考/v2/items的返回体)。

默认取值:

不涉及

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

start_time

String

参数解释:

时序起始时间。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

data

Dict[List]

参数解释:

各item的时序预测结果。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

error_msg

String

参数解释:

错误信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求示例

{"items": ["生活家电", "生活家电/空调"]}

响应示例

{
  "start_time": "2026-4-25",
  "data": {
    "生活家电": [35, 64, 98],
    "生活家电/空调": [22, 35, 12]
  }
}

状态码

请参见状态码

错误码

请参见错误码

相关文档