- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
- 服务端SDK
-
常见问题
- 高频常见问题
- 产品咨询
-
购买计费
- 视频点播提供了哪些套餐包?如何使用?
- 如何查看点播套餐包的使用详情?
- 点播CDN流量包是什么?对计费模式是否有限制?
- 套餐包是否可以续费以及重复购买?
- 购买套餐包是否有地域限制?
- 购买的媒体处理服务的转码套餐包,能在视频点播的转码功能中使用吗?
- 购买了转码套餐包,为什么没有抵扣转码时长?
- 为什么充值后还是提示欠费?
- 购买了套餐包,为什么账户提示欠费?
- 日峰值带宽是如何计算的?如何计费的?
- 购买了H.265的转码套餐包,是否可以变更为H.264规格的?
- 购买的套餐包还未使用,是否可以申请退款?
- 按流量计费和按带宽计费有什么区别?
- 点播的CDN流量包是否可以和CDN的流量包通用?
- 点播套餐包过期了怎么办?
- 转码套餐包中的已使用时长是如何计算的?
- 账户欠费资源的保留期有多久?
- 点播服务不使用的情况下是否需要退订?
- 点播的视频流量是如何计费的?
- 视频转码一进多出是如何计费的?
- URL拉取是如何收费的?
- 如何计算点播CDN加速流量?
- 使用工作流是如何计费的?
- 通过同一终端ID重复观看某个视频,是否会重复计费?
- 音视频审核是否计费?
- 账单中产品为“点播录制”的费用项收取的是什么费用?
- 为什么流量包中的流量使用量与数据分析中的流量显示存在差别?
- 为什么CDN加速域名没有业务,却产生了流量费用?
- 权限管理
- 域名管理
- 消息订阅
-
上传问题
- 视频点播支持上传哪些格式的音视频文件?
- 视频点播有哪些音视频上传方式?
- 是否支持压缩上传视频文件?
- 单个视频文件大小的上传是否有限制?
- 视频点播对视频存储是否有限制?
- 视频文件名最大命名长度是多少?
- 视频上传时间过长怎么办?
- 为什么上传音视频后,无法获取到音视频的时长?
- 点播控制台是否支持断点续传?
- 如何避免上传重复文件?
- 视频点播的本地上传的存储和费用是什么样的?
- 为什么视频上传后,在控制台找不到了?
- 通过控制台上传,页面自动退出登录导致上传失败
- 音视频上传后,多久可以播放?
- 上传一个视频文件需要多久?
- 为什么无法上传媒资?
- 为什么在控制台上传封面后不显示?
- 点播视频是否支持微信小程序上传?
- 点播上传视频是否需要上传封面?
-
音视频处理问题
- 如何在本地查看视频详细信息?
- 如何为视频增加字幕?
- 如何在点播控制台导出全部音视频信息?
- 为什么在控制台的视频截图中无法看到所有上传的视频文件?
- 音视频管理中的时长是指转码时长还是片源时长?
- 视频点播是否有内置系统模板?
- 音视频转码支持哪些输入格式?
- 音视频转码支持哪些输出格式?
- 如何将视频转码成多种分辨率格式?
- 是否支持同时对一个视频使用多个转码模板进行转码?
- 转码成HLS格式,生成的索引文件是否会产生费用?
- 为什么转码输出的视频分辨率与转码模板设置的不一致?
- 为什么转码有时很快有时很慢呢?
- 视频转码输入分辨率是否支持8K?
- 转码会导致音视频文件的大小产生变化吗?
- 为什么删除媒资失败?
- 转码模板设置了三路输出,为什么实际只有两路输出?
- 点播服务是否支持转码回调?
- 为什么视频转码/切片后,时长与播放器中看到的时长不一致?
- CDN预热为什么会失败?
- 为什么无法删除水印模板?
- 如何实现对上传音视频进行先审后发?
-
播放问题
- 视频播放效果是否有地域上的区别?
- DASH、HLS和MP4格式有什么播放体验区别?
- 如何获取音视频文件的播放URL?
- 如何在移动端播放点播音视频?
- 视频点播控制台预览播放支持哪些格式?
- 复制HLS流播放URL到浏览器中无法播放
- 播放HLS格式视频卡顿怎么办?
- 上传的原始视频预览失败怎么办?
- 视频播放URL是否支持生成二维码?
- 视频上传后必须转码才能播放吗?
- 使用自有域名,为什么视频播放失败?
- 不购买转码套餐包,视频能播放吗?
- 为什么HLS加密视频播放失败?
- 点播服务是否对同时在线观看人数有限制?
- 为什么访问播放地址返回403?
- 可以使用自有播放器播放上传到点播的音视频吗?
- 点播服务生成的播放地址中可以替换成自有的域名?
- HLS加密视频播放模糊不清?
- 为什么无法获取已转码视频的播放地址?
- 为什么播放转码视频出现卡顿?
- key防盗链配置后,转码的m3u8格式的视频为什么播放不了?
- 使用HLS加密的视频二次转码后为什么无法播放?
- 为什么视频在电脑浏览器中可以正常播放,而手机端却无法播放?
-
API&SDK使用
- 如何获取临时AK/SK/securityToken?
- 为什么调用查询媒资信息接口返回的媒资时长为0?
- 调用点播API时返回“租户ID校验失败,请检查”
- 调用API删除媒资时返回“The throttling threshold has been reached”
- 调用CDN预热接口,返回成功是指预热成功吗?
- 密钥查询接口的调用频率超过100次/分钟怎么办?
- 处理媒资时,为什么提示“当前媒资或资源状态不支持该操作”?
- 服务端SDK有哪些版本?
- 为什么调用"查询指定媒资的详细信息"接口时,返回结果中的“source_path”和“output_path”参数为空?
- 调用SDK或API上传视频过程中取消上传,如何删除已经上传的分段视频?
- 调用api上传视频文件后,为什么无法获取封面?
- 如何设置AK/SK和securitytoken的有效期?
- 调用API上传水印图片后,为什么在控制台上无法预览?
- 安全类问题
- 统计分析
- 故障排除
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
构造请求
本节介绍REST API请求的组成,并以调用IAM服务的管理员创建IAM用户来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。
您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987。
请求URI
请求URI由如下部分组成:
{URI-scheme}://{Endpoint}/{resource-path}?{query-string}
尽管请求URI包含在请求消息头中,但大多数语言或框架都要求您从请求消息中单独传递它,所以在此单独强调。
参数 |
描述 |
---|---|
URI-scheme |
表示用于传输请求的协议,当前所有API均采用HTTPS协议。 |
Endpoint |
指定承载REST服务端点的服务器域名或IP,不同服务不同区域的Endpoint不同,您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 |
resource-path |
资源路径,即API访问路径。从具体API的URI模块获取,例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 |
query-string |
查询参数,是可选部分,并不是每个API都有查询参数。查询参数前面需要带一个“?”,形式为“参数名=参数取值”,例如“?limit=10”,表示查询不超过10条数据。 |
例如您需要创建IAM用户,由于IAM为全局服务,则使用任一区域的Endpoint,比如“华北-北京四”区域的Endpoint(iam.cn-north-4.myhuaweicloud.com),并在管理员创建IAM用户的URI部分找到resource-path(/v3.0/OS-USER/users),拼接起来如下所示。
1 |
https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users |

为方便查看,在每个具体API的URI部分,只给出resource-path部分,并将请求方法写在一起。这是因为URI-scheme都是HTTPS,而Endpoint在同一个区域也相同,所以简洁起见将这两部分省略。
请求方法
方法 |
说明 |
---|---|
GET |
请求服务器返回指定资源。 |
PUT |
请求服务器更新指定资源。 |
POST |
请求服务器新增资源或执行特殊操作。 |
DELETE |
请求服务器删除指定资源,如删除对象等。 |
HEAD |
请求服务器资源头部。 |
PATCH |
请求服务器更新资源的部分内容。 当资源不存在的时候,PATCH可能会去创建一个新的资源。 |
在管理员创建IAM用户的URI部分,您可以看到其请求方法为“POST”,则其请求为:
1 |
POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users |
请求消息头
附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。
名称 |
描述 |
是否必选 |
示例 |
---|---|---|---|
Host |
请求的服务器信息,从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口,https的默认端口为443。 |
否 使用AK/SK认证时该字段必选。 |
code.test.com or code.test.com:443 |
Content-Type |
消息体的类型(格式)。推荐用户使用默认值application/json,有其他取值时会在具体接口中专门说明。 |
是 |
application/json |
Content-Length |
请求body长度,单位为Byte。 |
否 |
3495 |
X-Project-Id |
project id,项目编号。请参考获取项目ID章节获取项目编号。 |
否 如果是专属云场景采用AK/SK认证方式的接口请求,或者多project场景采用AK/SK认证的接口请求,则该字段必选。 |
e9993fc787d94b6c886cbaa340f9c0f4 |
X-Auth-Token |
用户Token。 用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头(Headers)中包含的“X-Subject-Token”的值即为Token值。 |
否 使用Token认证时该字段必选。 |
注:以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ |
API同时支持使用AK/SK认证,AK/SK认证使用SDK对请求进行签名,签名过程会自动往请求中添加Authorization(签名认证信息)和X-Sdk-Date(请求发送的时间)请求头。
AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。
对于管理员创建IAM用户接口,使用AK/SK方式认证时,添加消息头后的请求如下所示。
1 2 3 4 |
POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users Content-Type: application/json X-Sdk-Date: 20240416T095341Z Authorization: SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=**************** |
请求消息体(可选)
该部分可选。请求消息体通常以结构化格式(如JSON或XML)发出,与请求消息头中Content-Type对应,传递除请求消息头之外的内容。若请求消息体中的参数支持中文,则中文字符必须为UTF-8编码。
每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。
对于管理员创建IAM用户接口,您可以从接口的请求部分看到所需的请求参数及参数说明,将消息体加入后的请求如下所示,其中加粗的字段需要根据实际值填写。
- accountid为IAM用户所属的账号ID。
- username为要创建的IAM用户名。
- email为IAM用户的邮箱。
- **********为IAM用户的登录密码。
POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users Content-Type: application/json X-Sdk-Date: 20240416T095341Z Authorization: SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=**************** { "user": { "domain_id": "accountid", "name": "username", "password": "**********", "email": "email", "description": "IAM User Description" } }
到这里为止这个请求需要的内容就具备齐全了,您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口,返回的响应消息头中的“X-Subject-Token”就是需要获取的用户Token。有了Token之后,您就可以使用Token认证调用其他API。