创建设备路由

POST /api/devices/$deviceId/routes

创建设备路由

URL参数

参数名 类型 必填 描述 限制
deviceId string 设备唯一标识

请求参数

参数名 类型 必填 描述 限制
sourceType string 请求源类型 APP:应用
WEB:web页面
DEVICE:设备
needResp boolean 是否需要响应
sourceDeviceId string 设备标识 仅当sourceType为DEVICE时需要
sourceDeviceKey string 设备秘钥 仅当sourceType为DEVICE时需要

请求样例

POST /api/devices/99e9c54d-d807-42c0-95d7-3f2e4755618c/routes HTTP/1.1
Host: 127.0.0.1:8080
Content-Type: application/json
Authorization: Bearer {token}
Cache-Control: no-cache
Postman-Token: 095ca2e6-82b4-57b1-5344-3f0ac2331f3a

{
  "sourceDeviceId": "1d5f8607-0246-4a33-a980-ff15504455c5",
  "sourceType": "DEVICE",
  "needResp": true
}

响应参数

参数名 类型 必填 描述 限制
id string 路由标识
protocol string 通讯协议
temporaryRole TemporaryRole 临时身份 当请求类型为WEB/APP时,会创建临时身份
expiredTime Date 路由失效时间 失效前可以调用刷新接口延长过期时间
route MessageRoute 发送消息参数

TemporaryRole

参数名 类型 必填 描述 限制
host string 通讯服务器地址
port Integer 端口
sslEnable Boolean 是否ssl加密
clientId String
username String
password String

MessageRoute

参数名 类型 必填 描述 限制
forwardTopic string 发送消息topic
ackTopic string 响应消息topic

响应样例

{
    "returnCode": 0,
    "result": {
        "id": "routePolicy:0cc11452-bcd7-436f-9628-0741cc066757",
        "protocol": "MQTT",
        "expiredTime": 1514617532278,
        "route": {
            "forwardTopic": "enno/out/json/99e9c54d-d807-42c0-95d7-3f2e4755618c",
            "ackTopic": "enno/out/json/1d5f8607-0246-4a33-a980-ff15504455c5"
        }
    }
}