首次接口调用
首次接口调用
用服务端 HTTP 完成一次实时预览取址。参数表不在本页,以链接的接口页为准。
准备
已创建应用,并持有 AppId、AppSecret。设备已在该开发者账号下,见 控制台完成首次实时预览。
步骤
- 按 签名 计算
sign:签名原始串为time:{time},nonce:{nonce},appSecret:{appSecret}(键值对,英文逗号分隔)。password为 AppSecret 的 SHA-256 小写十六进制;sign为以password为密钥的 HMAC-SHA256 后再 Base64。用签名页标准案例核对本地结果。 - 调用 accessToken 取得管理员 accessToken。文档写明有效期为 3 天,临近过期或返回
TK1002时重新获取,不要为了刷新而频繁调用。 - 调用 分页详情 device.detail.page 分页查询账号下的设备。用返回的
deviceId和channelList确认目标设备与通道号。capabilityIds只表示这台设备具备哪些能力,不要把它当作后续 get、set、invoke 的入参。 - 调用 bindDeviceLive 创建设备源直播地址。该接口返回所选码流的 HTTP 地址,并写明地址公开后他人可以直接查看画面。若需要 FLV 地址,再调用 createDeviceFlvLive;该页只说明创建 FLV 地址,没有写在浏览器中打开。
- 确认返回的
result.code为0。bindDeviceLive返回的 HTTP 地址到 直播服务 中打开,对照 控制台完成首次实时预览。createDeviceFlvLive只核对返回成功;该接口页没有写在浏览器中打开。
服务端 HTTP
上述调用都在服务端完成。请求体为统一结构:system(ver、appId、sign、time、nonce)、id、params。域名与示例见 开发规范。
验证成功
bindDeviceLive 返回成功,并且该 HTTP 直播地址能在控制台直播服务中打开并看到画面。FLV 接口只以返回成功为准。