如何在Salesforce REST API中查询包含&的文本？

问题根源 #

直接在URL的q参数里写带&的状态值，会被URL解析器当成参数分隔符；仅单独替换&为%26但未对整个SOQL语句做完整URL编码时，Salesforce无法正确解析SOQL结构，导致识别不了状态值。

解决方案1：对整个SOQL语句做完整URL编码 #

• 先写出原始SOQL语句：
  SELECT FIELDS(STANDARD) FROM Case WHERE Status IN ('Started','In Progress & Review','Completed')
• 对整个SOQL进行完整URL编码（包括空格、&等所有需要编码的字符），得到编码后的字符串：
  SELECT%20FIELDS(STANDARD)%20FROM%20Case%20WHERE%20Status%20IN%20('Started','In%20Progress%20%26%20Review','Completed')
• 将编码后的字符串作为q参数的值拼接进请求URL：
  {{instance_url}}/services/data/v55.0/queryAll?q=SELECT%20FIELDS(STANDARD)%20FROM%20Case%20WHERE%20Status%20IN%20('Started','In%20Progress%20%26%20Review','Completed')

解决方案2：改用POST请求传递SOQL #

避免URL编码的麻烦，用POST请求将SOQL放在请求体中：

• 请求URL：{{instance_url}}/services/data/v55.0/queryAll
• 请求头：Content-Type: application/json
• 请求体：

{
  "q": "SELECT FIELDS(STANDARD) FROM Case WHERE Status IN ('Started','In Progress & Review','Completed')"
}

这种方式无需对SOQL做任何编码，Salesforce能直接识别带&的状态值。

内容的提问来源于stack exchange，提问作者thamshid cc