Postman 进行 OAuth 鉴权流程指引

简介

腾讯会议 Postman模板调试工具是为方便开发者进行腾讯会议 Rest API 接口联调而提供第三方开发调试工具。目前该工具支持 OAuth 鉴权与接口调试。下文将描述如何利用 Postman 工具调试 REST API。

操作步骤

步骤1:调试前准备

我们提供两种方式导入模板。

方式1:在线运行 Postman 模板库

通过这种方式,当模板更新后,您可以通过 Merge Changes 方式获取最新内容。

1. 单击以下按钮。

Run in Postman

2. 单击 Fork Collection,登录账号或创建一个账号。

3. 再次单击 Fork collection,可以在 Collection 中看到导入进来的模板,切换环境为 oauth_environment 即导入完毕。

4. 您可以通过单击 Merge Changes 来获取最新内容。

方式2:将模板库文件导入 Postman 工具

在 Postman 中导入环境配置文件和接口模板,首先单击下面两个链接分别下载环境文件与接口集合文件到本地。

进入 Postman 并在 workspace 下单击 Import,导入两个文件。

如下图左侧 Tab 栏,Collection 中可以看到导入的新接口模板,里面接口包含 OAuth 鉴权环节接口和可供 OAuth 鉴权调试的会议 RestAPI ;Environment 中可以看到导入的环境,在这里可以配置环境参数,目前已提供一个测试应用用于调试,可以将其中内容替换为所测应用的信息。

环境参数中,将 sdk_id、secret、redirect_uri 替换为您测试应用的信息,您可以通过 腾讯会议 应用详情中查看。

步骤2:获取授权码

右上角切换环境为 oauth_environment,选择获取 auth_code,单击 send 发送请求。

复制这个链接到浏览器中打开,并且完成授权操作。

在浏览器 URL 处拿到 auth_code。

步骤3:获取 access_token

根据第二步中获取的 auth_code,调用此接口,替换 auth_code 内容。

获得 access_token、refresh_token 和 open_id。

步骤4:调用接口

准备 open_id 与 access_token,准备要测试的接口,以创建会议为例介绍调试过程:

1. 环境变量。

设置环境中的 OpenId 和 AccessToken 变量,替换为步骤2中获取到的自己刚才保存的值。

2. 编辑 Header。

根据 OAuth 鉴权 Header 要求,确认必填字段已填入。

3. 编辑 Params 和 Body,单击 send 发送请求。

4. 查看调试结果。

步骤5:刷新 access_token

由于 access_token 有效期为6小时,在过期之后需要通过 refresh_token 刷新 access_token 字段,用于继续正常调试接口。在 Body 中将 refresh_token 字段内容替换为请求 access_token 时获取到的 refresh_token 值。

下载 Postman 进行 OAuth 鉴权流程指引.pdf
文章内容是否对您有帮助?
有帮助
无帮助