Office365/Graph Api中联系人Weblink替代方案及页面跳转方法问询

我之前帮不少开发者解决过这个问题——确实Graph API里的联系人对象不像邮件、日历事件那样自带webLink属性，不过有几个实用的变通方法能实现跳转到Office 365页面查看联系人的需求：

1. 手动构造Outlook网页版的直接联系人链接 #

Outlook网页版支持通过联系人ID直接定位到详情页，你可以用Graph API获取到联系人的id属性后，拼接成以下格式的URL：

https://outlook.office.com/people/id/<contact-id>

把<contact-id>替换成你从Graph接口拿到的联系人ID，用户点击这个链接就能直接跳转到该联系人的Outlook网页版详情页，体验和自带webLink的消息、事件几乎一致。

2. 通过联系人邮箱构造搜索链接 #

如果担心ID拼接的兼容性（比如极少数租户的特殊配置），可以用联系人emailAddresses属性里的邮箱地址，构造搜索链接：

https://outlook.office.com/people/?q=<contact-email>

这个链接会直接在Outlook网页版的联系人页面搜索该邮箱对应的联系人，用户点击搜索结果就能进入详情页。好处是即使联系人ID有变动，只要邮箱正确就能精准找到目标联系人。

3. 用自定义扩展属性存储链接（长期维护可选） #

如果你的应用需要长期复用这个跳转链接，还可以给联系人对象添加自定义的openExtension属性，把构造好的Outlook网页链接存进去。后续调用Graph获取联系人时就能直接提取使用，不用每次拼接。示例请求（简化版）：

POST https://graph.microsoft.com/v1.0/me/contacts/{contact-id}/extensions
Content-Type: application/json

{
  "@odata.type": "microsoft.graph.openTypeExtension",
  "extensionName": "com.yourcompany.contactWebLink",
  "webLink": "https://outlook.office.com/people/id/<contact-id>"
}

之后获取联系人的接口返回结果里会包含这个扩展属性，直接取用即可。

内容的提问来源于stack exchange，提问作者Karlheinz Reinhardt