# 接口域名说明

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": "操作成功"
}