6.使用Postman调试API接口

6.1 说明

postman是一款功能强大的网页调试和模拟发送HTTP请求的Chrome插件，支持几乎所有类型的HTTP请求，操作简单且方便。 本文介绍如何使用postman调试api接口。

6.2 前置条件

• 访问 Psotman (opens new window) 官网，下载并安装7.2.2以上版本
• 下载 collection (opens new window)
• 下载 environment (opens new window)

6.3 配置环境

6.3.1 配置postman环境变量

• 单击右上角箭头所指图标，打开MANAGE ENVIRONMENTS窗口

• 点击右下角import，打开Import Environment窗口

• 点击选择文件导入已下载 environment (opens new window) 文件

• 右上角点击切换导入的环境文件

• 参数如下图
  

  参数名	说明
  url	服务接入地址
  ClientId	唯一的第三方开发者ID
  clientSecret	开发者账号对应的授权账号密钥
  Authorization	Bearer开头的访问令牌 例如：Bearer 0lemRvfLicjkHtno8r6wolAq8V7oLGe6 需要调用授权接口获取
  redirectUri	重定向 URI，需应用创建时的回调url
  applianceCode	设备虚拟ID，可在app中查看您的设备
  homegroupId	家庭ID，从用户信息接口返回中获取
  sceneId	场景ID，从场景列表接口返回中获取

6.3.2 导入collection接口文件

• 点击左上角import，打开import窗口
• 点击Upload Files导入已下载 collection (opens new window) 文件
• 导入成功后，如下图

6.4 调用Api

注意： 文档中环境变量参数仅供示例，ClientId与clientSecret请使用已再本平台注册并通过审核的开发者账户，其他参数获取请参照如下步骤获取

1. 在调用其他接口前，需要先调用授权接口获取访问令牌，通过授权相关接口获取访问令牌access_token，作为后续调试api必要参数使用，redirectUri请使用创建时的回调url
2. 除授权相关接口外，调用其他接口需在请求头中更换Signature签名，签名方式请参考签名摘要规则说明 现内置javaScript脚本实现自动加密，可直接实现请求无需手动加密
3. 在调用场景相关接口前，需先调用获取用户信息接口获取家庭id