问题描述
如何使用 Microsoft Graph Explorer?为什么说它是一个非常便利的 Microsoft Graph API 调试工具?
访问地址:
- 全球版(Global):https://developer.microsoft.com/graph/graph-explorer
- 中国版(21Vianet):https://graphexplorerchina.azurewebsites.net/
中国区(21Vianet)Graph Explorer 说明
如果测试的是 中国区 Microsoft 365(世纪互联运营) 环境,需要使用专门的 Graph Explorer China 站点:https://graphexplorerchina.azurewebsites.net/ 。
与全球版的区别,实际上:Header 配置相同/Request Body 相同/权限模型相同/请求方法相同/调试方式相同/返回结果格式相同
唯一需要关注的区别是 Endpoint 不同。
除了 Endpoint 不同之外,其余测试方法与 Global Graph Explorer 完全一致。因此,当需要验证中国区租户的 Graph API 时,只需切换到 Graph Explorer China,并将请求发送到中国区 Graph Endpoint 即可。
问题解答
Microsoft Graph Explorer 是微软官方提供的一个在线 API 调试与学习工具,能够直接在浏览器中调用 Microsoft Graph REST API,无需编写代码即可验证接口、查看返回结果、测试权限以及生成示例代码。
它是“用于方便地发起 Microsoft Graph REST API 请求并查看响应结果的开发者工具”,可用于 API 原型验证、故障排查和学习 Graph API。
一:Graph Explorer 的主要价值
对于支持工程师、开发人员和 IT 管理员来说,Graph Explorer 最大的优势是:
- 无需开发环境 : 打开网页即可测试 API。不需要安装 SDK、Postman 或编写 PowerShell 代码。适合快速验证问题。
- 实时查看 API 返回结果: 输入 Graph API URL 后即可获得 JSON 响应。方便确认属性名称、数据结构以及错误信息。
- 权限调试特别方便: 可以直接查看接口需要哪些 Permission。支持在线 Consent 权限。非常适合排查 401、403 等授权问题。
- 自动生成代码: 可将测试成功的请求转换成 C#、JavaScript、PowerShell、Go 等代码示例。减少开发成本。
- 支持全部 HTTP Method: GET,POST,PATCH,PUT,DELETE 不仅能查询数据,也能修改对象。
二:快速上手
访问:https://developer.microsoft.com/graph/graph-explorer。Graph Explorer 提供默认 Sample Tenant,也可以登录自己的租户。登录后能够访问自己租户中的资源并执行更多操作。
示例1:查看当前用户信息 GET https://graph.microsoft.com/v1.0/me
示例2:查看当前用户经理 GET https://graph.microsoft.com/v1.0/me/manager
示例3:查看邮箱 GET https://graph.microsoft.com/v1.0/me/messages
参考资料
Microsoft Graph 文档 : https://learn.microsoft.com/zh-cn/graph/
当在复杂的环境中面临问题,格物之道需:浊而静之徐清,安以动之徐生。 云中,恰是如此!