Xero API联系人端点授权异常：生产环境无法访问联系人

结合你描述的情况（测试环境/空白账套正常，生产账套仅联系人端点失效，其他API正常），可以从这几个方向排查：

• 数据量触发的限制：生产账套的联系人数量大概率远多于测试账套，调用Contacts端点时可能触发分页上限或数据超限。试试给请求加page=1参数，或者用where条件过滤（比如where=ContactStatus="ACTIVE"）缩小返回范围，看能不能正常响应。

• 账套的特殊配置：有些生产账套会开启联系人的高级权限设置，比如部分联系人被标记为私有，或者启用了数据隔离规则。先去Xero后台检查「联系人设置」里的权限选项，再试试调用单个联系人的端点（/Contacts/{具体ID}），确认是批量访问出问题还是所有联系人请求都失败。

• 应用权限的隐性遗漏：虽然用户是顾问权限，但应用层面的API权限可能没配全。去Xero开发者平台重新核对应用的权限列表，确保Contacts的读写权限都勾选了。另外一定要看API返回的错误信息——403/404这类状态码的具体描述，是定位问题的核心。

• 请求URL的细节问题：你提供的端点里api.xro是正确的，但注意参数的大小写（比如summaryOnly=True的大小写是否符合要求），或者参数编码是否有问题。用Postman直接调用生产账套的端点，排除代码层面的编码或请求构造错误。

• 查看Xero API日志：在Xero后台的「API日志」里找生产账套的联系人请求记录，看具体的错误码和原因，比如是否是INVALID_QUERY或PERMISSION_DENIED，这能直接帮你锁定问题。

内容的提问来源于stack exchange，提问作者Aly Dewji