Xero API [contacts]接口无法填充[ContactPersons]字段的求助

1. 使用includeContactPersons查询参数 #

这是Xero API专门提供的批量获取联系人关联人员信息的参数，设置为true后，批量调用Contacts接口即可直接返回包含ContactPersons的完整数据，无需逐个调用。

请求示例：

GET https://api.xero.com/api.xro/2.0/contacts?includeContactPersons=true

2. 关于If-Modified-Since的验证提示 #

根据Xero API的设计逻辑，当联系人的ContactPersons信息变更时，该联系人的UpdatedDateUTC字段会同步更新，因此If-Modified-Since参数会识别到这个变更并返回该联系人的完整数据（包含更新后的ContactPersons），后续测试可以重点验证这一点。

3. 批量ID查询优化（备选方案） #

如果因特殊情况无法使用includeContactPersons参数，可以一次性传入多个联系人ID（用逗号分隔）进行批量查询，减少接口调用次数：

GET https://api.xero.com/api.xro/2.0/contacts?ids=CONTACT_ID_1,CONTACT_ID_2,CONTACT_ID_3

Xero API允许单次请求传入多个ID，能大幅降低遍历调用的次数。

内容的提问来源于stack exchange，提问作者Franche van den Berg