跳到主要内容

API 认证

GeniSpace API 使用 API 密钥（API Key）进行身份认证。所有 API 请求必须在请求头中携带有效的认证信息。

获取 API 密钥​

  1. 登录控制台，进入 系统 → 服务集成
  2. 在 API 密钥管理区域，点击「创建 API 密钥」
  3. 妥善保管生成的密钥，密钥仅在创建时显示一次

使用方式​

在每个 API 请求的 HTTP 头部中添加 Authorization 字段：

Authorization: Bearer YOUR_API_KEY

请求示例​

curl -X GET https://api.genispace.cn/developer/api-agents \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

安全建议​

  • 不要在客户端代码中硬编码 API 密钥
  • 使用环境变量存储密钥
  • 定期轮换密钥
  • 如果密钥泄露，请立即在控制台中撤销并创建新密钥

权限范围​

API 密钥的权限范围取决于创建者的团队角色和订阅计划。密钥可以访问创建者所属团队的资源。

相关文档​