批量查询设备所属周期
接口描述
根据设备 SN 列表批量查询各设备关联的周期和生命周期。未关联周期的设备会补一条空记录（lifecycle_id 为 0），便于调用方区分"无周期"与"未查询"。
请求说明
| 接口ID |
协议 |
方法 |
PATH |
| 75 |
HTTPS |
POST |
/openapi/v1/cbs/user/devices/cycles |
PATH参数
无
URL参数
| 参数 |
类型 |
必填 |
说明 |
| accesskey_id |
string |
是 |
参见签名认证 |
| expires |
int |
是 |
参见签名认证 |
| signature |
string |
是 |
参见签名认证 |
HTTP请求头
| 字段 |
值 |
| Content-Type |
application/json |
请求参数
请求参数以Json格式放置于Body中，字段如下：
| 参数 |
类型 |
必填 |
说明 |
| sns |
string[] |
是 |
设备序列号列表，1-200 条，SN 格式见下方说明 |
设备 SN 格式：符合以下任一格式
- 16 位十六进制 + 连字符：
XXXXXXXX-XXXXXXXX（如 12345678-87654321）
- 20 位纯数字（如
12345678901234567890）
请求示例
POST https://open.vzicloud.com/openapi/v1/cbs/user/devices/cycles?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json
{
"sns": ["12345678-87654321", "12345678901234567890"]
}
返回说明
返回参数
| 参数 |
类型 |
说明 |
| items |
object |
以 SN 为 key 的映射对象 |
| + lifecycle_id |
int |
生命周期 ID，0 表示未入周期 |
返回示例
{
"items": {
"00000000-00000001": { "lifecycle_id": 2001 },
"12345678901234567890": { "lifecycle_id": 0 }
}
}