外部集成

外接调用 User-Agent 说明

了解外部客户端何时应发送可识别的 User-Agent 以及如何对请求头策略进行故障排除。

什么时候需要 User-Agent

OmniGateway 并不要求每个客户端都伪装成其他产品。然而,配置的上游或访问策略可能需要可识别的客户端 User-Agent。

仅当您选择的路线记录了要求时才启用或自定义此请求头。保持值稳定,以便请求日志保持可诊断性。

按此顺序配置请求头

  1. 首先设置正确的授权请求头并验证 401 不是由 API 密钥引起的。
  2. 在添加可选请求头之前确认协议和基本 URL。
  3. 启用发送其标准 User-Agent 的客户端选项,或者添加自定义值(如果路由需要)。
  4. 重新启动客户端并测试最小请求。
请求头示例
Authorization: Bearer $OMNIGATEWAY_API_KEYUser-Agent: your-client/version

解决与请求头相关的故障

  • 401 通常表示身份验证,而不是 User-Agent 策略。
  • 身份验证成功后的 403 可以指示令牌组或上游策略限制。
  • 除非客户端协议需要,否则不要同时发送 x-api-key 和 Bearer 身份验证。
  • 切换提供商时删除旧的代理请求头,以便旧凭据不会转发。