前言

说明

好的接口设计,不要有任何的歧义。

用户送的尽可能的少。

保证安全性、拓展性。方便问题的排查等等。

安全性

所有的系统,必须有对应的申请记录。方能调用,不然后续会非常乱。

系统的申请

appKey appSecret

这个一般可以和审批系统结合,或者初期管理员人工添加。

频率不高,但是比较重要。

鉴权

提供对应的 client 包,初期可以实现 java 等。

启动启动时,做一次统一的鉴权。

返回 token,后续根据 token 鉴权。

验签

可以考虑添加 checksum,保证安全性。

优先级较低。

接口

核心能力

核心接口:

1) 报警的核心接口

2) 查询报警状态的接口

其他的很多接口不那么重要。

报警接口

核心字段

  [plaintext]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
token 令牌 traceId 跟踪号 requestTime 时间 requestSystem 请求系统(可选?) outAlarmId 外部报警标识 type 报警类型 eventId 事件标识 title 标题 content 内容 ip IP appName 应用 time 时间 status 状态 level 级别 value 报警值 dataMap 数据信息 extraMap 附加属性 remark 报警备注 receiverList=[{ 收件人信息 type: "", value: "" }]

查询接口

  [plaintext]
1
2
3
4
5
6
token 令牌 traceId 跟踪号 requestTime 时间 requestSystem 请求系统(可选?) outAlarmId 外部报警标识

参考资料