add docs
This commit is contained in:
parent
b6af63866f
commit
efaa6f2fcd
@ -1,57 +0,0 @@
|
||||
# 签名算法的说明
|
||||
|
||||
## 约定token的值为
|
||||
aB3$dEfGhiJkLmNoPqRsTuVwXyZ!@#4f5e6d7c8b9a0f1e2d
|
||||
|
||||
## 所有接口都必须传递签名值,签名值算法如下:
|
||||
参数签名算法,算法逻辑如下:
|
||||
1. 将对象转换成JSON字符串str1, str1即为post请求中的body体
|
||||
2. 将str1和给定的token值进行拼接后,然后对字符串进行md5加密, 拼接格式如何: md5_str = md5($token + str1 + $token)
|
||||
3. md5_str放到post请求的header里面,格式如下: sign: md5_str
|
||||
|
||||
## 推送的数据格式
|
||||
```text
|
||||
method: post
|
||||
header:
|
||||
sign: md5($token + body + $token)
|
||||
content-type: application/json
|
||||
|
||||
body:
|
||||
{
|
||||
"count": 1, // 单位时间内发生的次数,目前固定为1,即每次发生后都推送
|
||||
"taskId": "0520101121011022700001_22706", // 点位编码 + 事件编码;用于确认同一个设备发送的同一类型的事件
|
||||
"eventInfo": {
|
||||
"occurrenceTime": "2024-11-29 09:01:40", // 事件发送的时间
|
||||
"location": "0520101121011022700001", // 产生该事件的设备的点位信息编码
|
||||
"description": "person", // 事件描述
|
||||
"category": "23104", // 事件分类信息, 目前系统中 (23104 动火离人 )
|
||||
"attachments": [
|
||||
{
|
||||
"url": "https://lgsiot.njau.edu.cn/upload/2024/11/29/2024-11-29-1732842080-1732842100.mp4", // 视频文件的url地址
|
||||
"name": "2024-11-29-17328420801732842100.mp4" // 视频文件的名称
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 推送消息返回格式
|
||||
|
||||
### 推送成功
|
||||
|
||||
```json
|
||||
{"result": "ok"}
|
||||
```
|
||||
|
||||
### 推送失败
|
||||
|
||||
```json
|
||||
{"error": {"code": -1, "message": "错误描述信息"}}
|
||||
```
|
||||
|
||||
## 推送机制
|
||||
|
||||
```text
|
||||
1. 当http请求效应的状态码为非200时,推送方尝试重复推送,直到返回的状态码为200(注意:如果接收方的服务器异常,可能会收到之前的消息)
|
||||
2. 当http请求效应的状态码为200时,推送方记录日志并推送吓一条消息
|
||||
```
|
||||
BIN
docs/jianguanzhihui/动火离人接口对接协议.pdf
Normal file
BIN
docs/jianguanzhihui/动火离人接口对接协议.pdf
Normal file
Binary file not shown.
10
docs/todo.txt
Normal file
10
docs/todo.txt
Normal file
@ -0,0 +1,10 @@
|
||||
动火离人
|
||||
|
||||
1. 事件需要分离,需要通过post发送到对端; 点位信息需要替换成中文, event_code也需要
|
||||
2. 有文档信息,按照文档
|
||||
|
||||
|
||||
1. 需要增加时间限制,多次上报,5分钟内只报一次;基于事件id来做过滤
|
||||
2. 实验室的电表推送 todo mqtt
|
||||
|
||||
实现一类推送器!! http的 mqtt的
|
||||
Loading…
x
Reference in New Issue
Block a user