自定义请求头

服务预设中没有对应的服务时，在 访问内容 → 添加访问 页底部展开 自定义认证（或在搜索框输入名称），按该服务的认证文档选择 自定义请求头。

获取与填写凭证

按服务文档获取 API Key 或 Token，并填写它要求的请求头名称及完整值。平台不会根据请求头名称推断值的格式：例如 Authorization 的值可能是 Bearer <token>、Basic 编码值或原始 API Key。

服务地址

在 访问目标 中，目标地址 只填主机名，例如 api.example.com，不带协议或路径；在折叠的 协议、路径和内网设置 中调整协议、端口、路径和方法。同一份凭证要用于多个地址时，点击 添加地址。各字段的含义见连接配置字段说明。

请求头

在 自定义请求头 中每行填写一个请求头的名称和值，点击 添加请求头 增加一行，最多 32 个。名称可以从提示的常见名称里选择，也可以自己输入；名称不区分大小写，不能重复，只能使用字母、数字和 -、_、. 等 HTTP 允许的符号，最多 128 个字符。Host、Content-Length、Connection、Keep-Alive、Transfer-Encoding、Upgrade、TE、Trailer 以及以 Proxy- 或 X-Ztag- 开头的名称由平台保留，不能使用，填写时该行会提示「该请求头名称由平台保留」。提示只提供名称，不会补全值。

这类凭证没有平台到期时间，需要定期更换时用 替换凭证：替换时要重新填写全部值，请求头名称保持不变。需要不同的请求头名称时，创建新的凭证。

验证

保存后，请 ZAI 用官方文档中的最小只读请求验证；凭证失效时用 替换凭证 更新。排查顺序见验证与排错。