该接口用于获取产品总数,支持根据参数获取全部产品、离线产品、在线产品数量。
请求接口
POST /api/device-product/_count
请求参数
参数为空时,获取产品总数。
名称 | 位置 | 类型 | 必选 | 说明 |
---|---|---|---|---|
X-Access-Token | header | string | 是 | 平台token |
body | body | object | 否 | - |
»» terms | body | [object] | 否 | 查询条件 |
»»» column | body | string | 否 | 条件属性名称,比如state |
»»» value | body | string | 否 | 条件属性值 column为state时,value为1表示正常,value为0表示禁用。 |
响应参数
以200 Response为例,响应参数如下:
名称 | 类型 | 必选 | 约束 | 中文名 |
---|---|---|---|---|
» message | string | true | none | 返回信息 |
» result | object | true | none | 返回结果 |
» status | integer | true | none | 响应状态码 |
» timestamp | integer | true | none | 时间戳 |
响应状态码
状态码 | 状态码含义 | 说明 |
---|---|---|
200 | OK | 成功 |
401 | Unauthorized | 登录状态已过期,token不能为空 |
500 | Internal Server Error | 服务器内部异常 |
Body示例
- 请求全部产品数量:
json
{}
{}
- 请求正常产品数量:
json
{
"terms":[
{
"column":"state",
"value":"1"
}
]
}
{
"terms":[
{
"column":"state",
"value":"1"
}
]
}
- 请求禁用产品数量:
json
{
"terms":[
{
"column":"state",
"value":"0"
}
]
}
{
"terms":[
{
"column":"state",
"value":"0"
}
]
}
返回示例
以200 Response为例:
json
{
"message":"success",
"result":627,
"status":200,
"timestamp":1692859683997
}
{
"message":"success",
"result":627,
"status":200,
"timestamp":1692859683997
}