返回文档总览
/ NMS 消息服务
NMS 消息服务
NMS 是平台提供的实时消息推送服务,支持 WebSocket、TCP Socket、MQTT 三种协议接入。创建消息服务后获得独立的 AppKey / AppSecret,服务之间完全隔离。
| 协议 | 连接方式 | 认证 |
|---|---|---|
| WebSocket | ws://host/nms/ws/{appKey} | URL 参数 secret |
| TCP Socket | host:9500(换行分隔 JSON 帧) | 首帧 auth |
| MQTT | host:1883(MQTT 3.1.1,QoS 0/1) | username=AppKey, password=AppSecret |
WebSocket 连接后先认证,再通过 sub / pub 订阅与发布主题;建议 30 秒心跳一次。并发连接数受套餐限制(免费 10 / 标准 100 / 专业 1000)。
// WebSocket 示例
const ws = new WebSocket('ws://host/nms/ws/你的AppKey?secret=你的AppSecret')
ws.onopen = () => ws.send(JSON.stringify({ action: 'sub', topic: 'orders' }))
ws.onmessage = (e) => console.log(JSON.parse(e.data))