概述
Postman是网页调试与辅助接口调用的工具,具有界面简便清晰、操作方便快捷的特性,可以处理用户发送的HTTP哀求,比方:GET,PUT、POST,DELETE等,支持用户修改HTTP哀求中的参数并返回响应数据。
为充实了解接口,发起提前获取应用侧API参考查阅。我们已经写好了Postman的collection,在Collection中接口的哀求结构体已经完成可以直接使用。
本文档以Postman为例,模拟应用服务器以HTTPS协议接入物联网平台,调测以下API接口:
前置条件
- 下载并安装Postman。若未安装,请参考安装Postman举行安装。
- 下载Collection。
- 已在管理控制台完成产物模型和编解码插件的开发。
安装并配置Postman
- 安装Postman。
- 访问Postman官网,下载并安装Windows 64位Postman最新版本。
说明:
- 安装Postman依赖.NET Framework 4.5组件。
- 如需下载Windows 32位Postman最新版本,访问此处下载。
- 填写邮箱、用户名和暗码注册Postman。
- 导入Postman环境变量。
- 单击右上角的图标,打开“MANAGE ENVIRONMENTS”窗口。
- 单击“Import”,在弹出的页面中,单击“选择文件”,导入IoTDA.postman_environment.json文件(下载Collection解压后获取)。
- 单击导入的“IoTDA”环境。
- 参考下表修改以下参数。
参数名
参数说明
IAMEndpoint
IAM终端节点,参考IAM地域和终端节点获取。
IoTDAEndpoint
物联网平台终端节点,参考2.e。
IAMUserName
IAM用户名,参考我的凭证获取。
IAMPassword
登录华为云的暗码。
IAMDoaminId
账号名,参考我的凭证获取。
region
开通装备接入服务的区域,参考物联网平台终端节点获取。
注意:账户与IAM的区别
- IoTDAEndpoint参考。进入控制台,选择左侧导航栏“总览”,单击“实例基本信息-接入信息”,根据相应的接入类型和协议选择对应的接入所在。 图1 总览-获取接入信息
- 返回主页,选择环境变量为刚导入的“IoTDA”。
- 单击左上角的“Import”,单击“Choose Files”导入“应用侧API调用(V5版本).postman_collection.json”。
导入成功后,显示如下。
调测“获取IAM用户Token”接口
在访问物联网平台业务接口前,应用服务器需要调用“获取IAM用户Token”接口鉴权,华为云认证通过后向应用服务器返回鉴权令牌X-Subject-Token。
应用服务器需要构造一个HTTP哀求,哀求示比方下:
- POST https://<em><strong>iam.cn-north-4.myhuaweicloud.com</strong></em>/v3/auth/tokens
- Content-Type: application/json
- {
- "auth": {
- "identity": {
- "methods": [
- "password"
- ],
- "password": {
- "user": {
- "name": "username", <em><strong> IAM账号</strong></em>
- "password": "********", <em><strong>IAM密码</strong></em>
- "domain": {
- "name": "domainname" <em> 账号名</em>
- }
- }
- }
- },
- "scope": {
- "project": {
- "name": "<strong id="ZH-CN_TOPIC_0187472793__b18930395"><em id="ZH-CN_TOPIC_0187472793__i36155831">xxxxxxxx</em></strong>" <em> 项目区域:如:</em>cn-north-4
- }
- }
- }
- }
复制代码 参考API文档,调测获取IAM用户Token接口。
- 配置“获取IAM用户Token”接口的HTTP方法、URL和Headers。 注意:红字需要填写实际配置
- 配置“获取IAM用户Token”接口的Body。
- 单击“Send”,在下方查看返回码和响应消息内容。
- 请将返回头域中的的X-Subject-Token更新到“IoTDA”环境的“X-Auth-Token”参数中,以便于在调用其它接口时使用。若超过令牌有效时间,需要重新调用鉴权接口。
这里我们已经在postman中自动更新了“X-Auth-Token”参数,使用时无需手动操作。
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |