应用程序接口/API（Scalar）
API（Scalar）
v1.0.x · 已更新 2026-06-27
互动的 Scalar 用户界面 用于整个 AiHummer HTTP API 的浏览器。您的实例的每个端点都在这里：兼容 OpenAI 的聊天界面（POST /v1/chat/completions），入站消息和触发器，设备配对，SSO/SCIM 提供，以及完整的管理员 API——管理代理、知识、分析、模块和安全性。
打开 Scalar →
认证
请求通过 AiHummer API 密钥进行身份验证（前缀 ah-) 作为承载令牌发送：
Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
密钥从网络管理员用户界面发放。在 Scalar 用户界面中，点击 授权 并粘贴一个密钥以从浏览器运行实时“试一试”请求。
服务器
该规范随附一个 https://your-instance.example.com 占位符 — 从服务器下拉列表中选择您的实例地址，或用您自己的地址替换它（在生产环境中，TLS 在网关前的反向代理处终止）。
[!TIP]
机器可读规范可在以下位置获得 /openapi.json 和
可以干净地导入到 Postman、Insomnia 或 editor.swagger.io。
接下来去哪儿
互动的 **Scalar 用户界面** 用于整个 AiHummer HTTP API 的浏览器。您的实例的每个端点都在这里：兼容 OpenAI 的聊天界面（`POST /v1/chat/completions`），入站消息和触发器，设备配对，SSO/SCIM 提供，以及完整的管理员 API——管理代理、知识、分析、模块和安全性。
<p style="margin:1.5rem 0;"> <a href="/api/" style="display:inline-block;padding:0.85rem 1.5rem;border-radius:10px;background:#F0632E;color:#1a0d08;font-weight:600;text-decoration:none;"> 打开 Scalar → </a> </p>
## 认证
请求通过 AiHummer API 密钥进行身份验证（前缀 `ah-`) 作为承载令牌发送：
```http
Authorization: Bearer ah-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```
密钥从网络管理员用户界面发放。在 Scalar 用户界面中，点击 **授权** 并粘贴一个密钥以从浏览器运行实时“试一试”请求。
## 服务器
该规范随附一个 `https://your-instance.example.com` 占位符 — 从服务器下拉列表中选择您的实例地址，或用您自己的地址替换它（在生产环境中，TLS 在网关前的反向代理处终止）。
> [!TIP]
> 机器可读规范可在以下位置获得 [`/openapi.json`](/openapi.json) 和
> 可以干净地导入到 Postman、Insomnia 或 editor.swagger.io。
## 接下来去哪儿
- 聊天端点详细说明： [聊天完成 API](/zh/v1.0/api/chat-completions).
- 入站消息和触发器： [入站与触发器](/zh/v1.0/api/inbound-triggers).
- 配对、单点登录和协议： [Webhooks、SCIM 和配对](/zh/v1.0/api/webhooks-scim-pairing).
