getStreamUrl：获取 RTSP 拉流地址
getStreamUrl：获取 RTSP 拉流地址
功能说明
返回 OAuth 项目下已授权设备通道的 RTSP 播放地址。system.appId 使用 OAuth 项目 Access Key，params.token 使用终端用户 OAuth access token。
token 通过 oauthTokenV2 获取。产品说明见 OAuth 2.0 授权。
请求地址
https://openapi-[DataCenter].easy4ip.com/openapi/getStreamUrl
请求格式
请求参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| token | String | 是 | 终端用户 OAuth access token（Ot_） |
| deviceId | String | 是 | 设备序列号 |
| productId | String | 否 | IoT 设备 product id |
| channelId | Integer | 是 | 通道号 |
| streamId | Integer | 是 | 码流类型：0 主码流，1 子码流 |
请求示例
{
"system": {
"ver": "1.0",
"appId": "<OAuth Project Access Key>",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time": 1603366946,
"nonce": "2e84717c-0f22-4424-8afe-19bab0d6d606"
},
"id": "051824b1-9655-4755-9cc2-adcc9ab5fef1",
"params": {
"token": "Ot_xxxxxxxxxxxxxxxxxx",
"deviceId": "TESTQWERXXXX",
"channelId": 0,
"streamId": 0
}
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| url | String | RTSP 地址，可用第三方播放器播放 |
响应示例
{
"result": {
"msg": "The operation was successful.",
"code": "0",
"data": {
"url": "rtsp://example.lechange.com/live/xxxxxxxx"
}
},
"id": "051824b1-9655-4755-9cc2-adcc9ab5fef1"
}
错误码
网关与鉴权（SN / TK / OP）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SN1001 | 签名校验异常 | 按 HTTP 开发规范 核对 sign |
TK1002 | token 无效或过期 | 重新获取 accessToken |
OP1002 | 缺少必填参数 | 补必填字段 |
OP1003 | 参数不合法 | 按本页参数表核对 |
OP1009 | 权限不足 | 核对 token 与设备绑定/分享权限 |
OP1013 | 接口总次数超限 | 降低调用频率 |
OP1014 | 接口日限额超限 | 见 接口调用限额 |
DV1007 | 设备离线 | 等设备上线 |
更多见 错误码 · OP/SN/TK。
子账号（SUB）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SUB1001–SUB1002 | 子账号无接口权限 | 在 addPolicy 中补策略 |
SUB1005 | 子账号 token 过期 | 重新 subAccountToken |
SUB1006 | 子账号与设备无授权 | 核对 Resource 与设备序列号 |
SUB1008 | 子账号未绑定应用 | 先创建并绑定子账号 |
更多见 错误码 · SUB。