管理组织服务与凭证配置
API Key(x-api-key 请求头)
为要求 x-api-key 请求头的服务配置 API Key。
适用于组织 Owner / Admin;成员的个人连接器同样适用
在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 API Key,使用 推荐配置。名称默认填为 API Key(x-api-key 请求头),可以在 更多设置 里修改。
获取与填写凭证
从目标服务的账号设置、开发者设置或该服务的管理员处取得 API Key,并核对它的调用权限。
只有服务文档明确要求 x-api-key 请求头时才使用这个预设,把 Key 原样填入 API Key。服务要求的是 api-key、Authorization 或其他请求头时,切换到 自定义 填写,或改用自定义请求头。
这类凭证没有平台到期时间,需要定期更换时用 替换凭证。
服务地址
服务地址 填写目标 API 的 HTTPS 地址,只写主机和可选的端口,例如 https://api.example.com 或 https://api.example.com:8443;不带路径、查询参数或内嵌账号,也不要填该服务的网站页面地址。需要限制路径时切换到 自定义。
请求头
推荐配置固定使用 x-api-key 请求头,只需填写值。切换到 自定义 后,在 自定义请求头 中填写名称和值:名称可以从提示的常见名称里选择,也可以自己输入。替换凭证时只需重新填写值,请求头名称保持不变。
验证
保存后,请 ZAI 用官方文档中最简单的只读 API 发一次请求,确认请求成功,且返回内容属于预期的账号、组织或实例。遇到 401 或 403 时的排查顺序见验证与排错。