获取语音对讲地址
接口描述
获取设备语音对讲地址,要能够成功访问此接口并得到语音对讲地址有几下几个条件:
- 该设备已经被绑定到你的账号下
- 设备支持此功能(请与臻识销售咨询您的设备是否支持)
请求说明
接口ID | 协议 | 方法 | PATH |
---|---|---|---|
16 | HTTPS | GET | /openapi/v1/stp/user/devices/talk |
PATH参数
无
URL参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
accesskey_id | string | 是 | 参见签名认证 |
expires | int | 是 | 参见签名认证 |
signature | string | 是 | 参见签名认证 |
sn | string | 是 | 设备序列号 |
注:要在浏览器里与设备进行语音对讲,必须确保浏览器打开的网页是https协议。
请求示例
GET https://open.vzicloud.com/openapi/v1/stp/user/devices/talk?sn=6593d05e-34c85fbd&accesskey_id=7eQ8kIcf1125fDVz4dnBJhMh7n9tSGGy&expires=1600763374&signature=mGZdL636IzUyw5zpBppYSinwAOc%3D HTTP/1.1
Host: open.vzicloud.com
注意:您无法将请求示例的链接地址贴入浏览器直接运行,此示例仅展示URL格式,由于AccessKey具备有效期,您访问时此链接已过期。
返回说明
返回参数
参数 | 类型 | 说明 |
---|---|---|
proto | string | 当前固定为wss |
url | string | 播放地址 |
注意:接口返回的url包含有效期,请千万不要将返回的url存储长期使用,否则有效期过了将无法进行语音对讲。
返回示例
{
"url": "wss://video12.vzicloud.com/talk?target=VIrObJEVdG9Gd01n1bU1fboIJ-7nTfMqJxAdf3txi5CkjzaDxaHJL8RrGfAGB6mOALHYjpyAwkLSRK78GRetphVfpwlK0DXqM_Q6OdO0x3kVOTaCzxHHjOCx2JSGPgUN&full_https=true",
"proto": "wss"
}