# 接口域名说明
HTTP请求URL约定如下:
请求类型 | 域名 |
---|---|
HTTP请求 | https://www.sdzhiot.top/api/[版本]/[uri] |
注:当前最新版本为
V3
,使用旧版本请联系业务员
# Header 数据要求
除了获取 Token 的接口外,其他接口都需要在 Header 中传递 Token 的值,token 的获取方式参见token 获取 (opens new window)
Authorization: zh.ce9660acbb3a138e65016bebee61d5f7.a4525a422b98c0087d7003b239946e96
# HTTP响应应答格式说明
开放平台HTTP请求格式约定如下
- 非列表数据
字段列表 字段类型 字段说明 code Integer 请求返回码,具体详见全局返回码说明 msg String 请求返回码描述字符串,具体详见全局返回码说明 data Map 请求接口返回的具体内容信息,值为组装好的对象
{
"msg": "操作成功",
"code": 200,
"data": {
"expireTime": 1628735186330,
"accessToken": "zh.ddb5046ee489d93d189a826f5fa81d30.8f38b2ccc0f58ac59e44f4ec33604899"
}
}
- 列表数据
字段列表 字段类型 字段说明 code Integer 请求返回码,具体详见全局返回码说明 msg String 请求返回码描述字符串,具体详见全局返回码说明 total Integer 数据总条数 list Array 对象数组
{
"code": 0,
"data": {
"list": [
{
"sno": "171CB7400949",
"name": "蚊子智能监测",
"address": "铁力4号",
"position": "[119.024214,33.577788]",
"status": 1,
"heartbeat": 1634948515000,
"latestTime": 1745280028000
},
{
"sno": "B7A3814EC12B",
"name": "展厅虫情识别演示平台",
"address": null,
"position": null,
"status": 1,
"heartbeat": 1716520723000,
"latestTime": 1745224322000
}
],
"total": 2
},
"msg": "操作成功"
}
token获取 →