接收方拟定
POST
参数名称 | 参数类型 | 必须 | 参数说明 |
---|---|---|---|
secret_key | string | Y | 密钥 key |
Content-Type | string | Y | Text/plain |
Timestamp | int | Y | 秒时间戳 |
X-Sm-Sign | string | Y | 签名 签名生成算法 |
1.通过请求头中的 secret_key获取到对应密钥;
2.md5( 请求体 + 请求头 timestamp + 密钥 ) 生成签名;
3.服务端比较生成的签名与 header 中的 X-Sm-Sign 签名是否一致判断数据完整性。
1.对 body 进行 base64 解码;
2.对解码后的数据进行 AES/CBC/PKCS5Padding 解密(密钥通过请求 header secret_key 映射获得);
3.对解密后的数据进行 zlib 解压缩;
4.对上一步数据进行业务相关的数据解析,最终拿到业务数据。
参数名称 | 参数类型 | 必须 | 参数说明 |
---|---|---|---|
req_id | string | Y | 请求唯一标识 |
data | []object | N | 错误码描述信息 |
|device_id | string | N | 设备id |
|tracks | object | N | |
||lng | string | N | 经度,坐标系与入参坐标系一致 |
||lat | string | N | 纬度,坐标系与入参坐标系一致 |
||time | string | N | 轨迹时间 |
Example
[
{
"req_id":"6JSE0qOxVahIx8NX5OlOCW",
"data":{
"device_id":"e7777de0698a1b172cfa4751ccfee673",
"id_type":"mac",
"tracks":[
{
"lng":"114.917716",
"lat":"27.026271",
"time":"1682324986"
},
{
"lng":"114.917716",
"lat":"27.026271",
"time":"1682324980"
},
{
"time":"1682324994",
"lng":"114.917716",
"lat":"27.026271"
},
{
"lng":"114.917716",
"lat":"27.026271",
"time":"1682324950"
}
]
}
}
]
参数名称 | 参数类型 | 必须 | 参数说明 |
---|---|---|---|
device_id | string | Y | 设备id |
id_type | string | Y | 设备类型 |
fence_id | string | Y | 围栏id |
time | string | Y | 时间 |
Example
[
{
"device_id":"f6f4d9ae977817e7",
"id_type":"oaid",
"fence_id":"3F6epM1LD86nLCngoPufxid7ioN",
"time":"2022-09-22 15:15:38"
}
]
成功响应 http code 200