求助：HCM Cloud REST API多查询参数匹配员工失效问题

我来帮你搞定这个问题！你遇到的情况是因为查询参数的格式不符合Oracle HCM Cloud REST API的要求，导致第二个条件被API忽略了。

问题根源 #

你当前的URL写法是把两个查询条件拆成了两个独立的URL参数：

https://host:port/hcmCoreApi/resources/11.12.1.0/emps/?q=DateOfBirth=1991-09-19&PersonNumber=240

这里API只会识别q参数里的DateOfBirth=1991-09-19，后面的PersonNumber=240会被当作无关的额外参数，自然不会生效。

正确的写法 #

Oracle HCM Cloud的REST API要求所有查询条件都放在同一个q参数中，并用逻辑运算符（比如AND）连接，同时字符串/日期类型的参数需要用单引号包裹。

修正后的查询URL应该是这样的：

https://host:port/hcmCoreApi/resources/11.12.1.0/emps/?q=DateOfBirth='1991-09-19' AND PersonNumber='240'

额外注意事项 #

• 字段大小写：HCM Cloud API的字段名是区分大小写的，要确保DateOfBirth和PersonNumber的拼写和官方文档完全一致，避免因为大小写错误导致条件不生效。
• URL编码：如果你的请求工具需要手动编码URL，记得把特殊字符转义：
  • = 转成 %3D
  • ' 转成 %27
  • 空格转成 %20
    编码后的URL示例：

  https://host:port/hcmCoreApi/resources/11.12.1.0/emps/?q=DateOfBirth%3D%271991-09-19%27%20AND%20PersonNumber%3D%27240%27
  

• 日期格式：确认你的日期格式YYYY-MM-DD符合API要求，这个格式是HCM Cloud API通用的日期格式，没问题。

这样修改后，API就会同时校验DateOfBirth和PersonNumber两个条件，返回匹配的员工数据啦！

内容的提问来源于stack exchange，提问作者Harshita Sethi