消息通知服务 SMN-HTTP(S)消息格式:操作场景
操作场景
- 接收 SMN 服务发送的HTTP(S)消息时,终端证书的CN名称请参考业界规范,部分特殊字符可能导致https消息发送失败。
- 在互联网上传递未加密的http协议消息内容存在信息泄漏风险,推荐用户终端添加订阅时对接通道优先使用https类型。
描述SMN服务向HTTP(S)终端发送消息的格式,您可以通过消息头部信息中的消息类型来区分消息格式。消息格式包括:HTTP(S)订阅确认消息的格式、HTTP(S)推送消息的格式和HTTP(S)取消订阅消息的格式三种消息格式,HTTP/HTTPS协议均为POST方式。
当SMN服务向HTTP(S)终端发送消息时,头部包括请求X-SMN-MESSAGE-TYPE,X-SMN-MESSAGE-ID,X-SMN-TOPIC-URN,如表1所示。
参数 |
说明 |
---|---|
X-SMN-MESSAGE-TYPE |
消息类型,消息类型分别有:
|
X-SMN-MESSAGE-ID |
消息唯一标识。 |
X-SMN-TOPIC-URN |
主题的唯一标识,表示消息归属的主题。 |
关于HTTP(S)头部字段的说明:
- RFC 7230 章节3.2中规定,HTTP(S)头部的字段名称不区分大小写。
- RFC 7540 章节8.1.2中规定,对于支持HTTP/2的服务端,头部字段信息需要统一改为全小写。
- 对于用户自定义的HTTP(S)头部字段,SMN也将采用上述的处理策略。
- 用户如果从HTTP(S)头部中获取相关字段,建议采用不区分大小写的方式。