跳到主要内容
开发者

API 密钥

为你自己的软件创建密钥，并在每次请求 HANC API 时一并发送。

API 密钥让你自己的软件可以使用 HANC API：列出通话、创建代理、购买号码、读取你的 CRM。密钥以你的权限行事——你在控制台中能做的，它都能通过 API 完成。

创建密钥​

  1. 打开密钥

    集成 → 开发者 标签页 → 工作区 API 密钥。

  2. 创建一个

    点击 创建 API 令牌。密钥会出现在列表中；点击显示按钮即可看到它，并从那里复制。

  • 每个工作区最多 3 个密钥。
  • 密钥没有名称，也没有单独的权限：密钥在你所属的每个工作区中都拥有你的访问权限。
  • 密钥可以从列表中再次显示——请把这个列表视为敏感信息。

使用密钥​

在 x-api-key 请求头中发送密钥，不要加 Bearer 前缀：

curl "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

所有端点都在 API 参考 中有说明。

妥善保管​

  • 把密钥保存在你的服务器上——绝不要放在浏览器、移动应用或任何用户能打开的地方。
  • 绝不要把它们提交到版本控制中。
  • 定期更换密钥；有人离开或密钥可能泄露时，立即删除该密钥。
本页内容