如何通过API调用使用CaseNumber获取Salesforce案例详情？

当你用CaseNumber直接以ID路径调用API时会返回NOT_FOUND，因为CaseNumber不是Salesforce的主键ID，需要用以下方式实现：

方法一：SOQL查询 #

构造查询请求，通过query端点筛选CaseNumber：

• 请求URL示例：

  https://your-salesforce-instance/services/data/v59.0/query?q=SELECT+Id,Subject,Description+FROM+Case+WHERE+CaseNumber+=+'0001234'
  

• 说明：
  • 将your-salesforce-instance替换为你的Salesforce实例域名
  • v59.0替换为你使用的API版本
  • '0001234'替换为目标CaseNumber，注意必须加单引号
  • 可以根据需求调整SELECT后的字段列表

方法二：利用外部ID（需配置） #

如果将CaseNumber设置为外部ID，可直接通过字段值查询：

1. 在Salesforce后台进入对象管理器→Case→字段与关系，找到CaseNumber字段
2. 编辑字段，勾选外部ID选项并保存
3. 调用API端点：

   https://your-salesforce-instance/services/data/v59.0/sobjects/Case/CaseNumber/0001234
   

注意事项 #

• 确认CaseNumber完全匹配：包括前缀、数字部分，避免多余空格或格式错误
• 检查权限：确保调用API的用户拥有该Case的查看权限，以及Case对象的查询权限
• API版本：建议使用较新的API版本，避免兼容性问题

内容的提问来源于stack exchange，提问作者rach pole