调用ZenDesk Search API带日期查询参数时遇无效参数异常

报错原因 #

你遇到的Invalid argument <api_url>异常，核心原因是请求URL中的特殊字符未做URL编码：
你的查询参数里使用了solved>2025-07-01和solved<2025-07-30，其中<和>属于URL保留字符，直接放在URL中会被HTTP客户端或ZenDesk服务器错误解析，导致整个请求地址格式无效。

修复方案 #

有两种可行的修复方式：

• 方式1：对特殊字符进行URL编码
  将>替换为%3E，<替换为%3C，修改后的请求地址为：

  ${ZENDESK_URL}/api/v2/search.json?query=type:ticket ticket_form_id:${TICKET_FORM_ID} status:solved solved%3E2025-07-01 solved%3C2025-07-30
  

• 方式2：使用ZenDesk支持的日期范围语法
  ZenDesk Search API支持用..表示范围，并用引号包裹，这样可以避免特殊字符：

  ${ZENDESK_URL}/api/v2/search.json?query=type:ticket ticket_form_id:${TICKET_FORM_ID} status:solved solved:"2025-07-01..2025-07-30"
  

补充说明 #

虽然ZenDesk官方文档标注这些查询参数逻辑合法，但URL传输时必须遵守HTTP规范——保留字符必须编码或通过语法规避，否则会触发地址解析错误。你替换其他日期字段（如updated、closed_at）时仍报错，也是因为同样的未编码问题。

内容的提问来源于stack exchange，提问作者ab.it.gcp