3. Postman工具调试API¶
Postman - REST Client是一款免费的API调试工具,在谷歌、火狐浏览器的应用商店通过添加扩展应用即可使用。
3.1. Postman工具获取可用Token¶
- 启动Postman应用,在打开的Postman页面窗口中:请求URL(request URL)框中填 https://console.plcloud.com/api/,请求方式选择GET。(注:Headers菜单内容不需填写)
- 获取登录服务器所需参数csrfmiddlewaretoken值:单击“Send”菜单,等待“Cookies”菜单返回“csrftoken”值,获取cookies中csrftoken对应的值“p76hxZqufNbZ1OP1dWRS6e7h6kpCrPTi”
- 认证注册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
- 单击步骤3中的“Send”菜单,检查csrftoken是否登录服务器认证成功,如果“Status”为“200 OK”,“Body”返回内容标题没有“403 Forbidden”信息,则登录认证成功。csrfmiddlewaretoken就是我们后面需要使用的X-CSRFToken值。
3.2. Postman工具测试API¶
当Content-Type为application/json时,POSTMAN工具测试 API 的方法如下
- 单击“Normal”菜单,请参考下面截图内容填写API测试数据
- 步骤1红色方框中内容填写完成后,点击“Send”发送请求数据,返回后的数据参考如下图:
当Content-Type为application/x-www-form-urlencode时,POSTMAN工具测试 API 的方法如下
- 单击“Normal”菜单,请参考下面截图内容填写API测试数据
- 步骤1红色方框中内容填写完成后,点击“Send”发送请求数据,返回后的数据参考如下图