如何基于Xero API构建已创建联系人的访问URL?
构建Xero联系人的直接访问链接
核心解决方案
Xero官方API文档确实没有明确列出构建联系人详情页链接的方法,但社区已验证两种可靠的实现方式:
方法1:使用租户UUID(推荐,API直接返回)
这种方式无需依赖ShortCode,直接用API已返回的字段构建链接:
- 从
GET /connections端点获取目标租户的tenantId(UUID格式,如abc12345-6789-0abc-def1-234567890abc) - 从联系人创建/查询接口获取目标联系人的
ContactID(UUID格式) - 拼接链接:
https://go.xero.com/Contacts/ContactView.aspx?contactID={CONTACT_ID}&tenantID={TENANT_ID}
替换{CONTACT_ID}和{TENANT_ID}为实际值即可,该链接可直接跳转至对应联系人的详情页,无需用户手动切换组织。
方法2:使用组织ShortCode
若偏好手动URL的格式,可通过API获取组织的ShortCode(即你提到的6字符代码):
- 调用
GET /api.xro/2.0/Organisation端点,返回的Organisation对象中包含ShortCode字段(如ABC123) - 拼接链接:
https://go.xero.com/app/{SHORT_CODE}/Contacts/ContactView.aspx?contactID={CONTACT_ID}
ShortCode是组织的固定标识,不会随意变更,可靠性有保障。
注意事项
- 两种链接格式均经过社区验证,可安全用于存储、邮件发送等场景
- 无需依赖不可靠的前端临时参数,所有字段均通过官方API获取
内容的提问来源于stack exchange,提问作者Dave F
相关产品推荐
相关产品推荐

