状态码
状态码 描述
200 查询应用列表
400 语义有误，当前请求无法被服务器理解，或参数有误 500 查询出错，服务器端错误
错误码
请参见错误码。
5.3 查询单个应用
功能介绍
调用此接口查询单个应用详情。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/apps/{app_id}
表5-23 路径参数
参数 是否必选 参数类型 描述
app_id 是 String 应用id
请求参数
表5-24 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 内容类型。
API 参考 5 应用管理
参数 是否必选 参数类型 描述
X-Auth-Token 否 String 用户Token。使用Token鉴权方 式时必选。通过调用IAM服务获 取用户Token接口获取（响应消 息头中X-Subject-Token的 值）。
Authorization 否 String 使用AK/SK方式认证时必选，携 带的鉴权信息。
X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请 求的发生时间。
X-Project-Id 否 String 使用AK/SK方式认证时必选，携 带项目ID信息。
响应参数
状态码： 200
表5-25 响应 Header 参数
参数 参数类型 描述
X-request-Id String 此字段携带请求ID号，以便任务跟踪。
表5-26 响应 Body 参数
参数 参数类型 描述
app_name String app名称 app_id String 应用id state AppState
object app状态 scope String RTC覆盖范围。
取值如下：
● DOMESTIC：国内范围。
● OVERSEA：海外范围。
● GLOBAL：全球范围。
tenant_name String 账号名
domain String 域名，App对应域名 create_time String 创建时间，形如
“2006-01-02T15:04:05.075Z”，时区为：UTC
API 参考 5 应用管理
参数 参数类型 描述 authenticatio
n AppAuth
object 鉴权配置 callbacks AppCallbacks
object 回调配置 auto_record_
mode AppAutoReco
rdMode object
自动录制配置
表5-27 AppState
参数 参数类型 描述
state String 状态
● ACTIVATION：开启
● DEACTIVATION：停用
● ARREARS：欠费
● DELETED：已删除 update_time String app鉴权的更新时间，形如
“2006-01-02T15:04:05.075Z”，时区为：UTC
表5-28 AppAuth
参数 参数类型 描述
enable Boolean 开启或关闭URL鉴权
expire Integer 接入RTC建链认证时的signature的有效期。单 位：秒。默认300秒。signature由app_key生成 app_key String app鉴权秘钥
update_time String app鉴权的更新时间，形如
“2006-01-02T15:04:05.075Z”，时区为：UTC
表5-29 AppCallbacks
参数 参数类型 描述
push_callback AppCallback
Url object 转推回调 record_callbac
k AppCallback
Url object 录制回调
API 参考 5 应用管理
表5-30 AppCallbackUrl
参数 参数类型 描述
url String 回调通知url地址，url必须以http://或https://开 头，需要支持POST调用。
auth_key String 回调秘钥，主要用于鉴权。如果不设置或者为 空，则回调不会增加鉴权头域字段。
notify_event_s
ubscription Array of
strings 订阅云端录制通知消息。
取值如下：
● RECORD_NEW_FILE_START：开始创建新的录 制文件。
● RECORD_FILE_COMPLETE：录制文件生成完 成。
update_time String 更新时间，形如
“2006-01-02T15:04:05.075Z”，时区为：
UTC。
表5-31 AppAutoRecordMode
参数 参数类型 描述
mode String 录制模式。
● AUTO_RECORD_OFF：关闭自动录制。
● AUTO_INDIVIDUAL_RECORD：开启单流自动 录制，此时record_rule_id必须非空。
record_rule_id String 录制规则id。
update_time String 更新时间，形如
“2006-01-02T15:04:05.075Z”，时区为：
UTC。
状态码： 400
表5-32 响应 Header 参数
参数 参数类型 描述
X-request-Id String 此字段携带请求ID号，以便任务跟踪。
API 参考 5 应用管理
表5-33 响应 Body 参数
参数 参数类型 描述
error_code String 错误码 error_msg String 错误描述
状态码： 404
表5-34 响应 Header 参数
参数 参数类型 描述
X-request-Id String 此字段携带请求ID号，以便任务跟踪。
表5-35 响应 Body 参数
参数 参数类型 描述
error_code String 错误码 error_msg String 错误描述
状态码： 500
表5-36 响应 Header 参数
参数 参数类型 描述
X-request-Id String 此字段携带请求ID号，以便任务跟踪。
表5-37 响应 Body 参数
参数 参数类型 描述
error_code String 错误码 error_msg String 错误描述
请求示例
GET https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}
响应示例
状态码： 200
API 参考 5 应用管理
app详细信息
{ "app_name" : "example",
"app_id" : "123456789abcdefghijklmno", "state" : {
"state" : "ACTIVATION",
"update_time" : "2020-07-26T07:03:05.075Z"
}, "scope" : "DOMESTIC",
"tenant_name" : "hwstaff_pub_videortc",
"domain" : "123456789abcdefghijklmno.rtc.huawei.com", "project_id" : "ad7456ce8ef89adf567",
"create_time" : "2020-07-26T07:03:05.075Z", "authentication" : {
"enable" : true, "expire" : 300,
"app_key" : "12345ABCDEF12345",
"update_time" : "2020-07-26T07:03:05.075Z"
}, "callbacks" : { "record_callback" : {
"url" : "http://mydomain.com", "auth_key" : "78912374ae8cdb38",
"update_time" : "2020-07-26T07:53:05.075Z"
}
}, "auto_record_mode" : {
"mode" : "AUTO_RECORD_OFF",
"update_time" : "2020-07-26T07:53:05.075Z"
}}
状态码： 400
语义有误，当前请求无法被服务器理解，或参数有误
{ "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue"
}
状态码： 404 app编号不存在
{ "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue"
}
状态码： 500
查询失败，服务器端错误
{ "error_code" : "RTC.00002xxx", "error_msg" : "InternalError"
}
状态码
状态码 描述
200 app详细信息
400 语义有误，当前请求无法被服务器理解，或参数有误
API 参考 5 应用管理
状态码 描述
404 app编号不存在
500 查询失败，服务器端错误
错误码
请参见错误码。