3. Postman工具调试API

Postman - REST Client是一款免费的API调试工具,在谷歌、火狐浏览器的应用商店通过添加扩展应用即可使用。

../_images/001.png

3.1. Postman工具获取可用Token

  1. 启动Postman应用,在打开的Postman页面窗口中:请求URL(request URL)框中填 https://console.plcloud.com/api/,请求方式选择GET。(注:Headers菜单内容不需填写)
../_images/002.png
  1. 获取登录服务器所需参数csrfmiddlewaretoken值:单击“Send”菜单,等待“Cookies”菜单返回“csrftoken”值,获取cookies中csrftoken对应的值“p76hxZqufNbZ1OP1dWRS6e7h6kpCrPTi”
../_images/003.png
  1. 认证注册csrftoken:单击“Normal”菜单,请填写如下内容:请求URL框中填 https://console.plcloud.com/auth/login/ ,请求方式选择POST,然后点击“x-www-form-urlencoded”菜单,在下方Key、Value处填写相应值如下表。(注:Headers菜单内容不需填写,csrfmiddlewaretoken对应步骤2中csrftoken值)。
Parameter name Type Description Required
username String 您已注册的宝德云帐号名称 Yes
password String 您的宝德云帐号对应密码 Yes
region String 认证地址,请填写 http://58.67.194.89:5001/v2.0 Yes
csrfmiddlewaretoken String csrfmiddlewaretoken的值为步骤2中的csrftoken值 Yes
../_images/004.png
  1. 单击步骤3中的“Send”菜单,检查csrftoken是否登录服务器认证成功,如果“Status”为“200 OK”,“Body”返回内容标题没有“403 Forbidden”信息,则登录认证成功。csrfmiddlewaretoken就是我们后面需要使用的X-CSRFToken值。
../_images/005.png

3.2. Postman工具测试API

当Content-Type为application/json时,POSTMAN工具测试 API 的方法如下

  1. 单击“Normal”菜单,请参考下面截图内容填写API测试数据
../_images/0011.png
  1. 步骤1红色方框中内容填写完成后,点击“Send”发送请求数据,返回后的数据参考如下图:
../_images/0021.png

当Content-Type为application/x-www-form-urlencode时,POSTMAN工具测试 API 的方法如下

  1. 单击“Normal”菜单,请参考下面截图内容填写API测试数据
../_images/0012.png
  1. 步骤1红色方框中内容填写完成后,点击“Send”发送请求数据,返回后的数据参考如下图
../_images/0022.png