腾讯云智能数智人数智人 aPaas 接口调用方式_AI解决方案_同尘科技

本文档主要描述腾讯云智能数智人 aPaas 平台接口调用方式，包括权限、公共参数、签名要求等。

一、接口调用环境

正式环境：https://gw.tvs.qq.com

二、权限申请及开通

需要申请开通权限才能调用云小微数智人 aPaas 接口。线下申请方式：由管理员为您开通对应的 appkey 和 accesstoken。自助申请方式：在腾讯云官网下单页面购买，从收到 站内信 中获取。

三、请求公共参数及签名方法

公共参数

在调用 aPaas 任一接口时，都需在 URL 中以 QueryString 形式携带以下公共参数：

签名方法

请求参数签名步骤如下：1. signature 签名规则如下，这里以下为例说明(示例仅供参考)

appkey = e38267c0e86411ebb02aed82acb0ed99accesstoken = f68f2d10ae9e4604b76fb05cf46bccec域名路由 = https://gw.tvs.qq.com/v2/ivh/videomaker/broadcastservice/videomake

2. 对除 signature 之外的所有参数按字典序进行排序，作为签名原文， 目前仅有 appkey 和 timestamp 两个参数，因此排序拼接后的字符串示例为：

appkey=e38267c0e86411ebb02aed82acb0ed99&timestamp=1646636485

3. 对签名原文使用 accesstoken 进行 HmacSha256 加密，之后再进行 base64 编码。

hashBytes = HmacSha256("appkey=e38267c0e86411ebb02aed82acb0ed99&timestamp=1646636485","f68f2d10ae9e4604b76fb05cf46bccec")signature = Base64Encode(hashBytes)

4. 得到 signature 签名值为：

BfWuaC9kmaicCggXc693uK+sZQ8qe88O4HVQNTdwZuo=

5. 将 signature 值进行 urlencode（必须进行 URL 编码，否则将导致鉴权失败偶现 ）后拼接得到最终请求 URL 为：

https://gw.tvs.qq.com/v2/ivh/videomaker/broadcastservice/videomake?appkey=e38267c0e86411ebb02aed82acb0ed99&timestamp=1646636485&signature=BfWuaC9kmaicCggXc693uK%2BsZQ8qe88O4HVQNTdwZuo%3D 

四、请求及响应结构

请求体结构请求体分为Header 和 Palyload 两个参数，在 Header 中可以携带 RequestID 用于标识唯一的一次请求，用于系统联合定位问题。业务参数均放在 Payload 中，各产品接口文档分册中每个接口的入参请放到 Payload 中传递。

{        "Header": {        "RequestID": "",    },    "Payload": {}}

响应体结构响应体分为 Header 和 Payload 两个参数，Header 中包含结果码、消息、以及请求唯一 ID，请求唯一 ID 与请求体中传入的值相同。接口具体的返回参数将放置在Payload 中。

{        "Header": {        "Code": 0,        "Message": "",        "RequestID": "", // 如果请求时未填写，由云端生成返回    },        "Payload": {}}



对解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案