调用DescribeApps分页查询白板应用信息。

使用说明

调用本接口前,您必须已经调用CreateApp创建白板应用。

QPS限制

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

调试

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

请求参数

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

系统规定参数。取值:DescribeApps

RegionId String cn-shanghai

地域ID。

AppID String 7mbj****

白板应用唯一标识符,参数为空默认查询所有应用ID。获取AppID,请参见CreateApp

AppStatus Long 1

白板应用状态,参数为空默认查询所有状态。取值:

  • 1:启用。
  • 2:停用。
PageNum Long 1

查询页码,参数为空默认查询第1页。

PageSize Long 10

每页显示个数,参数为空默认显示个数为10。

返回数据

名称 类型 示例值 描述
RequestId String FE22D613-D3C6-4A58-87CA-F21FC85AA08E

请求ID。

ResponseSuccess Boolean true

调用结果。

ErrorCode String null

错误码。

ErrorMsg String null

错误信息。

Result Object

返回的结果信息。

TotalNum Long 15

应用总个数。

TotalPage Long 5

应用总页数。

AppList Array of appList

应用详情列表。

AppID String 7mbj****

白板应用唯一标识符。

AppName String my_white_board

白板应用名称。

Status Long 1

白板应用状态。取值:

  • 1:启用。
  • 2:停用。
CallbackUrl String http://www.example.com/callback

白板应用回调地址URL。

DomainNames String www.example.com

合法域名列表,多个使用英文逗号(,)分隔。

CreateTime String 2020-04-10 12:20:30.567

白板应用的创建时间。

CallbackType String userPermissionCallback,whiteBoardProfileCallback,userProfileCallback,hostCheckCallback

白板应用的回调类型,多个使用英文逗号(,)分隔,all表示设置了全部回调。

示例

请求示例

http(s)://rtc-white-board.cn-shanghai.aliyuncs.com/?Action=DescribeApps
&AppID=7mbj****
&AppStatus=1
&PageNum=1
&PageSize=10
&公共请求参数

正常返回示例

XML格式

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

<DescribeAppsResponse>
    <RequestId>29D20DA7-985D-425E-89BD-26594D327DCC</RequestId>
    <ResponseSuccess>true</ResponseSuccess>
    <ErrorMsg/>
    <ErrorCode/>
    <Result>
        <TotalNum>15</TotalNum>
        <TotalPage>5</TotalPage>
        <AppList>
            <CallbackUrl>http://www.example.com/callback</CallbackUrl>
            <Status>1</Status>
            <AppID>zt87****</AppID>
            <CreateTime>2021-04-10 16:10:57.217</CreateTime>
            <DomainNames>www.example.com</DomainNames>
            <AppName>我的APP1</AppName>
            <CallbackType>userPermissionCallback</CallbackType>
        </AppList>
        <AppList>
            <CallbackUrl>http://www.example.com/callback</CallbackUrl>
            <Status>1</Status>
            <AppID>sf1g****</AppID>
            <CreateTime>2021-04-12 15:29:27.315</CreateTime>
            <DomainNames>www.example.com</DomainNames>
            <AppName>我的APP2</AppName>
            <CallbackType>userPermissionCallback,whiteBoardProfileCallback</CallbackType>
        </AppList>
        <AppList>
            <CallbackUrl>http://www.example.com/callback</CallbackUrl>
            <Status>1</Status>
            <AppID>5s77****</AppID>
            <CreateTime>2021-04-12 17:00:39.325</CreateTime>
            <DomainNames>www.example.com</DomainNames>
            <AppName>我的APP3</AppName>
            <CallbackType>userPermissionCallback,userProfileCallback</CallbackType>
        </AppList>
    </Result>
</DescribeAppsResponse>

JSON格式

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

{
  "RequestId" : "29D20DA7-985D-425E-89BD-26594D327DCC",
  "ResponseSuccess" : true,
  "ErrorMsg" : "",
  "ErrorCode" : "",
  "Result" : {
    "TotalNum" : 15,
    "TotalPage" : 5,
    "AppList" : [ {
      "CallbackUrl" : "http://www.example.com/callback",
      "Status" : 1,
      "AppID" : "zt87****",
      "CreateTime" : "2021-04-10 16:10:57.217",
      "DomainNames" : "www.example.com",
      "AppName" : "我的APP1",
      "CallbackType" : "userPermissionCallback"
    }, {
      "CallbackUrl" : "http://www.example.com/callback",
      "Status" : 1,
      "AppID" : "sf1g****",
      "CreateTime" : "2021-04-12 15:29:27.315",
      "DomainNames" : "www.example.com",
      "AppName" : "我的APP2",
      "CallbackType" : "userPermissionCallback,whiteBoardProfileCallback"
    }, {
      "CallbackUrl" : "http://www.example.com/callback",
      "Status" : 1,
      "AppID" : "5s77****",
      "CreateTime" : "2021-04-12 17:00:39.325",
      "DomainNames" : "www.example.com",
      "AppName" : "我的APP3",
      "CallbackType" : "userPermissionCallback,userProfileCallback"
    } ]
  }
}