本文主要介绍物联网视频服务云端API的请求结构和请求示例。
请求结构
您可以通过发送HTTP或HTTPS请求调用物联网视频服务API。
请求结构如下:
http://Endpoint/?Action=xx&Parameters
参数 | 说明 |
---|---|
Endpoint | 调用云服务的接入地址。物联网视频服务的接入地址格式:linkvisual.cn-shanghai.aliyuncs.com。 |
Action | 要执行的操作,即云端API的名称。例如,调用QueryDeviceRecordLifeCycle获取设备云存储录像生命周期。Action对应的值就是QueryDeviceRecordLifeCycle,即Action=QueryDeviceRecordLifeCycle。 |
Parameters | 请求参数。每个参数之间用& 符号分隔。 请求参数由公共参数和API自定义参数组成。公共参数中包含API版本号、身份验证等信息。 |
下面以调用QueryDeviceRecordLifeCycle获取设备云存储录像生命周期为例:
说明 本文示例均使用华东2(上海)地域的接入地址。为了便于阅读,本文中的示例均做了格式化处理。
https://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryDeviceRecordLifeCycle
&Format=xml
&Version=2018-01-20
&Signature=xxxx%xxxx%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&TimeStamp=2019-06-01T12:00:00Z
…
API在线调试
阿里云OpenAPI开发者门户提供API调试工具。在API调试页面,您可以快速检索和体验调用API。系统会根据您输入的参数同步生成各语言SDK的代码示例。各语言SDK代码示例显示在页面右侧SDK示例页签下供您参考。在调用结果页签下,可查看API调用的真实请求URL和JSON格式的返回结果。