转码API
目录 |
1. 接口描述
域名:wenzhi.api.qcloud.com
接口名: ContentTranscode
转码分为两大类:网页转码和网页名片。网页转码将在PC机上展示的二维页面转换为适合在手机等移动端设备上展示的一维页面,方便用户在移动端阅读。网页名片将页面简化为主体图片、标题、摘要的组合,以“卡片”的形式展示给大众,适合做页面的分享、收藏、推广等。用户只需要提交网页的 url ,就能获取我们的转码服务,方便、快捷。当前,网页转码已为公司QQ、qzone、微云、微博、正文吧等平台提供服务。
2. 输入参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
url | 是 | String | 网页地址 |
to_html | 是 | Int32 | 1 : html 0 : xml |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
code | Int32 | 错误码, 0: 成功, 其他值: 失败 |
message | String | 错误信息,错误码详情参见错误码说明 |
content | String | 转码结果 |
转码API错误码详细信息如下:
错误码 | 含义说明 |
---|---|
400 | HTTP Method不正确 |
401 | HTTP请求参数不符合要求 |
503 | 调用额度已超出限制 |
504 | 服务故障 |
4. 详细示例
示例业务详细信息如下表:
参数名称 | 参数描述 | 必选 | 参数值示例 | |
---|---|---|---|---|
腾讯云公共参数 | Action | 方法名 | 是 | ContentTranscode |
SecretId | SecretId | 是 | AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA | |
Timestamp | 当前时间戳 | 是 | 1408704141 | |
Nonce | 随机正整数 | 是 | 345122 | |
业务参数 | url | 网页地址 | 是 | www.163.com |
to_html | 1 : html 0 : xml | 是 | 1 |
下面以上述业务为例,详细说明“转码API”接口的使用方法。
4.1 接口鉴权
示例要调用服务的数据为:{"url":"www.163.com","to_html":1}
则上述业务的参数列表如下:
{ 'Action' : 'ContentTranscode', 'Nonce' : 345122, 'Region' : 'sz', 'SecretId' : 'AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA', 'Timestamp' : 1408704141, 'url': 'www.163.com', 'to_html': 1 }
根据上述参数列表进行签名,得出的数字签名为:HgIYOPcx5lN6gz8JsCFBNAWp2oQ(示例),详细的数字签名的生成方法请参照:《腾讯云接口鉴权》。
注意:
1)在生成签名的过程中,需要将加密字符串中包含的“_”改写成“.”,从而加密产生签名;
2)鉴权时,需要将参数列表按key进行排序:字典序,同时大写在前。
4.2 API调用
根据上一步(9.4.1)中得到的数字签名,以POST请求为例构造请求URL,将数字签名加入到参数Signature中。
https://wenzhi.api.qcloud.com/v2/index.php? Action=ContentTranscode &Nonce=345122 &Region=sz &SecretId=AKIDz8krbsJ5yKBZQpn74WFkmLPx3gnPhESA &Timestamp=1408704141 &Signature=HgIYOPcx5lN6gz8JsCFBNAWp2oQ &url=www.163.com &to_html=1
执行上述操作之后,会将数据{"url":"www.163.com","to_html":1}发送给API接口,进行相应分析。
注意:在发送请求过程中,不能将参数字符串中包含的“”改写成“.”。
以上信息是否解决您的问题?