目前硬件对话智能体的 OpenAPI 仅支持手动构造请求，并自行完成签名计算。 ## 完整请求结构一个有效的 OpenAPI 请求必须包含：**请求行 + 请求头（含签名）+ 请求体**。完整结构如下： ```HTTP # -------------------- Part 1: 请求行 -------------------- [Method] https://[Host]/?Action=[Action]&Version=[Version] # -------------------- Part 2: 请求头（需携带鉴权签名） -------------------- Host: [参考下方说明] Content-Type: [参考下方说明] X-Date: [动态生成的当前 UTC 时间] X-Content-Sha256: [根据 Part 3 请求体计算出的SHA256哈希值] Authorization: [必须进行签名，用于鉴权] # -------------------- Part 3: 请求体 -------------------- # 对于 POST 请求，这里是“接口特有参数” { "Parameter1": "Value1", "Parameter2": "Value2", ... } ``` ## 各部分说明 ### 请求行 * [Method]、[Action]、[Version] ：可在对应接口文档获取。以 [AibotCreate](https://www.volcengine.com/docs/6348/1807449) 接口为例，如下图所示： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bbdcc21e9553253e0ce9ff906d46b00d.png =361x) * [Host]：华北地域为 `rtc.volcengineapi.com`、亚太东南（柔佛）为 `open-ap-singapore-1.volcengineapi.com` ### 请求头（需携带鉴权签名） |**参数** |**如何获取 / 构造** | |---|---| |[Host] |服务接入点，与请求行中的保持一致。 | |[Content\-Type] |资源的 MIME 类型。对于 POST 请求，固定为 application/json；Get 请求中，该值可为空。 | |[X\-Date] |请求时间， UTC 格式（ISO 8601），精确到秒，例如 20201230T081805Z。 | |[X\-Content\-Sha256] |请求体的 SHA256 哈希值。若请求体为空，则使用一个固定的哈希值。 | |[Authorization] |**签名鉴权**。此值必须通过算法计算，用于验证您的身份和请求内容的完整性。具体方法请参见附录的[签名方法和示例](https://www.volcengine.com/docs/6348/1827277#w27IjC8T)。 | ### 请求体 JSON 格式，包含接口所需的业务参数（如 AppId、RoomId 等）。详细结构和字段说明，请参见对应的 [API 文档](https://www.volcengine.com/docs/6348/1197615)。 ## 附录 ### 签名方法和示例签名需要遵循一套严格的加密和规范化流程，你参考签名机制自行计算，或参考示例代码实现。 * **自行计算**：请参见[签名机制](https://www.volcengine.com/docs/6369/67269)。 * **签名示例**：[Golang](https://github.com/volcengine/volc-openapi-demos/blob/main/signature/golang/sign.go)、[Python](https://github.com/volcengine/volc-openapi-demos/blob/main/signature/python/sign.py)、[Java](https://github.com/volcengine/volc-openapi-demos/blob/main/signature/java/Sign.java)、[PHP](https://github.com/volcengine/volc-openapi-demos/blob/main/signature/php/sign.php)、[Node.js](https://github.com/volcengine/volc-openapi-demos/blob/main/signature/nodejs/sign.js) 上述示例是一个通用的框架，在使用时需要根据具体需求修改文件中的配置变量信息和接口调用参数。 * **替换配置变量**： * AK、SK：访问 [API访问密钥](https://console.volcengine.com/iam/keymanage/) 页面创建并获取。 * Service：固定为 `rtc`。 * Region、Host： |**地域** |**Region** |Host | |---|---|---| |华北 |cn\-north\-1 |rtc.volcengineapi.com | |亚太东南（柔佛） |ap\-southeast\-1 |open\-ap\-singapore\-1.volcengineapi.com | * **设置接口参数**： * Action / Version：来自具体 API 文档。 * Body 或 Query：业务参数，参考具体的 API 文档。 ### 事件和错误码 * [公共错误码](https://www.volcengine.com/docs/6348/70426) * [事件和错误码](https://www.volcengine.com/docs/6348/1928198)

实时音视频