文档

查询流鉴权

查询当前在线流的鉴权

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DescribeLiveStreamAuthChecking

系统规定参数。取值:DescribeLiveStreamAuthChecking

DomainName String demo.aliyundoc.com

直播推流域名或播流域名。

Url String http://example.com/live/test.flv?auth_key=1664248******

完整的推流地址或播放地址。

返回数据

名称

类型

示例值

描述

Description String INVALID AUTH_KEY

鉴权不通过的错误信息。

RequestId String 16F08B4E-14FD-5D72-AB2F-BAFA4C4D57F1

请求ID。

Status String pass

鉴权是否有效。

  • pass:有效。
  • false:无效。

鉴权不通过原因说明

名称

描述

INVALID AUTH_KEY

鉴权URL的参数auth_key无效。

INVALID TIMESTAMP

鉴权URL的时间无效。

INVALID ALIAUTH

配置的鉴权方式无效。

INVALID MD5HASH

通过MD5算法计算出的字符串无效。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeLiveStreamAuthChecking
&DomainName=demo.aliyundoc.com
&Url=http://example.com/live/test.flv?auth_key=1664248******
&公共请求参数

正常返回示例

XML格式

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

<DescribeLiveStreamAuthCheckingResponse>
    <Status>pass</Status>
    <Description/>
    <RequestId>16F08B4E-14FD-5D72-AB2F-BAFA4C4D57F1</RequestId>
</DescribeLiveStreamAuthCheckingResponse>

JSON格式

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

{
  "Status" : "pass",
  "Description" : "",
  "RequestId" : "16F08B4E-14FD-5D72-AB2F-BAFA4C4D57F1"
}

错误码

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