如何使用 Postman 工具进行有赞云接口测试

说明:

由于现阶段有赞云还未正式发布 API 接口调试工具,导致很多开发者在接口调试过程中极为不方便。本文主要介绍如何使用 Postman 工具进行有赞云接口测试。

PART1:Postman 背景介绍

用户在开发或者调试网络程序或者是网页 B/S 模式的程序的时候是需要一些方法来跟踪网页请求的,用户可以使用一些网络的监视工具比如著名的 Firebug 等网页调试工具。今天给大家介绍的这款网页调试工具不仅可以调试简单的 css、html、脚本等简单的网页基本信息,它还可以发送几乎所有类型的 HTTP 请求!Postman 在发送网络 HTTP 请求方面可以说是 Chrome 插件类产品中的代表产品之一。

PART2:Postman 下载与安装

postman 适用于不同的操作系统,Postman Mac、Windows X32、Windows X64、Linux 系统,还支持 postman 浏览器扩展程序、postman chrome 应用程序等。
官方下载地址:https://www.getpostman.com/downloads/
注:
1)官方下载地址:https://www.getpostman.com/downloads/
2)更多关于 postman 的安装问题可以参考此链接:https://blog.csdn.net/fxbin123/article/details/80428216

PART3: 接口请求流程

1. 有赞云 API 介绍
1)API 结构组成:
一个 API 主要由 api 名称、api 版本、鉴权方式、请求方法、请求参数和返回参数组成;
下面举个例子来说明,如接口 youzan.logistics.expressbyorderno.get.3.0.0

API 名称 (name) youzan.logistics.expressbyorderno.get
版本 (version) 3.0.0
鉴权方式 token
请求方法 (method) POST
请求参数 tid (string)
返回参数 {“code”:“int”,“data”:{“com”:“string”,“created_time”:“date”,“express_id”:“int”,“data”:“string”,“nu”:“string”,“name”:“string”,“id”:“long”,“state”:“int”,“message”:“string”,“status”:“string”},“success”:“boolean”,“message”:“string”}

2)有赞云 API 协议
所有 Api 调用采用统一协议 Https 进行传输,请求采用 post + json 的模式,请求 token 放 url 请求参数里,接口的请求参数放请求的 body 里

2.POST 请求
1)自用型应用获取 token

POST https://open.youzanyun.com/auth/token
Content-Type: application/json
{
  "authorize_type": "silent",
  "client_id": "oauth_test",
  "client_secret": "oauth_test",
  "grant_id": "12345"
}

Postman 请求示例:
image.png
image.png

2)请求调用有赞云接口
海淘电子口岸列表获取接口:youzan.shop.crossborder.list.1.0.0
image.png

图片上传接口:youzan.materials.storage.platform.img.upload.3.0.0
image.png

注意:
所有的接口调用统一要使用 post + json 的模式