Configures callbacks for video moderation results. As a result, a callback URL that is used to receive the callback notifications is added.

Usage notes

  • The automated review feature sends notifications about violations to the callback URL in real time. Then, you can manually review the content and take actions accordingly.
  • Only some live centers support the automated review feature. For more information, see Supported regions.

QPS limit

You can call this operation up to 30 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limit on an API operation in ApsaraVideo Live.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer automatically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes AddLiveDetectNotifyConfig

The operation that you want to perform. Set the value to AddLiveDetectNotifyConfig.

DomainName String Yes example.com

The main streaming domain.

NotifyUrl String Yes http://demo.aliyundoc.com/examplecallback.action

The callback URL that is used to receive callback notifications about violations, such as pornographic content and politically sensitive content, detected in live streams.

Response parameters

Parameter Type Example Description
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=AddLiveDetectNotifyConfig
&DomainName=example.com
&NotifyUrl=http://demo.aliyundoc.com/examplecallback.action
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<AddLiveDetectNotifyConfigResponse>
	<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveDetectNotifyConfigResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidNotifyUrl.Malformed Specified NotifyUrl is invalid. The error message returned because the callback URL is invalid. Check whether the value of the NotifyUrl parameter is valid.
400 InvalidNotifyUrl.Unsafe Specified NotifyUrl is not safe. The error message returned because the callback URL is unsecure. Check whether the value of the NotifyUrl parameter is valid.
400 ConfigAlreadyExists Config has already exist. The error message returned because the configuration already exists.

For a list of error codes, see Service error codes.