调用TriggerRecord触发录像。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String TriggerRecord

系统规定参数。取值:TriggerRecord。

IotId String zLZyi6aOLyOSHa9hsPyD000100

设备ID。可调用物联网平台QueryDeviceDetail查询。

RecordDuration Integer 60

录像时长(秒),包含预录时间。

PreRecordDuration Integer 30

预录时长(秒)。

StreamType Integer 0

码流类型:

  • 0(默认值):主码流
  • 1:辅码流

API调用的其他公共请求参数,请参见公共请求参数

返回数据

名称 类型 示例值 描述
Code String MissingParamter

调用失败时,返回的错误码。

Data String eventid1

请求成功时返回录像ID。

ErrorMessage String XXXis mandatory for this action

调用失败时,返回的出错信息。

RequestId String 06DC77A0-4622-42DB-9EE0-25FIOHS82JK1

请求ID。

Success Boolean true

表示是否调用成功:

  • true表示调用成功
  • false表示调用失败

示例

请求示例


http(s)://[Endpoint]/?Action=TriggerRecord
&IotId=zLZyi6aOLyOSHa9hsPyD000100
&RecordDuration=60
&<公共请求参数>

正常返回示例

XML 格式

<TriggerRecordResponse>
      <RequestId>06DC77A0-4622-42DB-9EE0-25FIOHS82JK1</RequestId>
      <Success>true</Success>
      <Data>eventid1</Data>
</TriggerRecordResponse>

JSON 格式

{
	"TriggerRecordResponse":{
		"Data":"eventid1",
		"RequestId":"06DC77A0-4622-42DB-9EE0-25FIOHS82JK1",
		"Success":true
	}
}

错误码

访问错误中心查看更多错误码。