- 最新动态
- 服务公告
- 产品介绍
- 产品彩页
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 应用示例
- 资产管理
- 分身视频制作
- 分身视频直播
- 智能交互
- 分身形象制作管理
- 声音制作任务管理
- 语音合成管理
- 租户管理
- 附录
- 修订记录
- 服务端SDK参考
- 场景代码示例
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
创建第三方直播平台
功能介绍
该接口用于创建第三方直播平台。
调用方法
请参见如何调用API。
URI
POST /v1/{project_id}/live-platforms/platforms
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取。 响应消息头中X-Subject-Token的值。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 格式为(YYYYMMDD'T'HHMMSS'Z')。 |
X-Project-Id |
否 |
String |
使用AK/SK方式认证时必选,携带项目ID信息。 |
X-App-UserId |
否 |
String |
第三方用户ID。不允许输入中文。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
直播平台名称 |
auth_config |
是 |
CustomPlatformAuthConfig object |
自定义直播平台鉴权配置 |
callback_config |
是 |
Array of StandardPlatformApiConfig objects |
自定义直播平台回调配置。同一种类型仅保留一个配置,如果配置多个会随机保存一个。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
key |
是 |
String |
密钥Key。调用自定义直播平台时使用。 使用方式: 调用接口时,增加两个头域:x-hw-mss-time,x-hw-mss-secret
示例: 66df9308(即2024.09.10 08:30:00)
示例: URL https://api.example.com/v1/products?live_id=111&limit=10&offset=0 Key:GCTbw44s6MPLh4GqgDpnfuFHgy25Enly hwTime:66df9308 x-hw-mss-secret=hmac_sha256(GCTbw44s6MPLh4GqgDpnfuFHgy25Enly,api.example.com/v1/products?limit=10&live_id=111&offset=066df9308)=5e7fe8869a12a87ea966d9edbc02e38cd4ce62c73b8b05c638f15835e78902d7 x-hw-mss-secret: 5e7fe8869a12a87ea966d9edbc02e38cd4ce62c73b8b05c638f15835e78902d7 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
X-Request-Id |
String |
请求ID。 |
参数 |
参数类型 |
描述 |
---|---|---|
platform_id |
String |
平台ID |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
GET https://metastudio.xxxx.myhuaweicloud.com//v1/123456xxx/live-platforms { "name" : "百联云店", "auth_config" : { "key" : "xxx11243" }, "callback_config" : [ { "api_type" : "PRODUCT_QUERY", "url" : "https://api.example.com/products" } ] }
响应示例
状态码:200
成功。
{ "platform_id" : "f7df49cbc2e74efa8a85f2ab1d6c46d3" }
状态码:400
请求传参异常,包含错误码及对应描述。
{ "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" }
状态码:401
未鉴权或鉴权失败。
{ "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" }
状态码:500
内部服务错误。
{ "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }
状态码
状态码 |
描述 |
---|---|
200 |
成功。 |
400 |
请求传参异常,包含错误码及对应描述。 |
401 |
未鉴权或鉴权失败。 |
500 |
内部服务错误。 |
错误码
请参见错误码。