1.下载Postman桌面版APP
链接为:Download Postman | Get Started for Free
2. 安装 Postman
根据你选择的操作系统架构,下载的是一个 .tar.gz
文件(通常是 Linux 版本),安装过程如下:
(1)解压下载的文件
假设你下载了 Postman
的 Linux 版本(例如,Postman-linux-x64.tar.gz
),你需要解压它。
-
打开终端并导航到你下载文件的位置。
-
使用以下命令解压文件:
tar -xvzf postman-linux-x64.tar.gz
(2)将 Postman 移动到合适的目录(可选)
为了方便后续的启动,你可以将解压后的 Postman 文件夹移动到 /opt
目录下:
sudo mv Postman /opt/
(3)创建快捷方式(可选)
你可以通过创建一个快捷方式来方便启动 Postman。
创建一个新的 桌面快捷方式 文件:
sudo nano /usr/share/applications/Postman.desktop
在打开的编辑器中,添加以下内容:
[Desktop Entry]
Name=Postman
Comment=Postman API Platform
Exec=/opt/Postman/Postman
Icon=/opt/Postman/resources/app/assets/icon.png
Terminal=false
Type=Application
Categories=Development;
这个配置文件将帮助你从应用菜单中直接启动 Postman。
保存并退出编辑器(按 Ctrl + O 保存,然后按 Ctrl + X 退出)。
(4)启动 Postman
现在,你已经安装并创建了快捷方式,你可以从终端或应用菜单启动 Postman。
-
从终端启动:
在终端输入以下命令来启动 Postman:
/opt/Postman/Postman
- 通过应用菜单启动:
如果你创建了快捷方式,你可以直接从你的 Linux 桌面应用菜单中找到 Postman 并点击启动。
3. 登录或注册
启动 Postman 后,如果你还没有 Postman 账户,你可以选择注册一个账户;如果已有账户,可以直接登录。你也可以选择 跳过登录,在本地使用 Postman 进行 API 测试。
4.启动你的 Go 应用(或者别的应用)
确保你在本地启动了 Go 服务。例如,如果你在 main.go
中使用 http.ListenAndServe(":8080", router)
启动了服务器,确保应用正在运行并监听 http://localhost:8080
。
go run main.go
5.使用 Postman 测试 API
启动 Postman 后,你可以开始配置和测试你的 API 请求:
测试注册接口:
- 打开 Postman,点击左上角的 New 按钮创建一个新请求。
- 选择 POST 方法。
- 在 URL 栏中输入你本地服务的地址,例如:
http://localhost:8080/register
。 - 切换到 Body 选项卡,选择 raw 并设置格式为 JSON。
- 输入以下 JSON 数据进行注册:
{
"username": "my_username", #数据库的用户表中用户名字段为username
"password": "my_password", #数据库的用户表中密码字段为password
"email": "user@example.com" #数据库的用户表中邮箱字段为email
}
点击 Send 发送请求。如果注册成功,你应该会收到一个成功响应(例如 200 状态码),并且返回一个 User registered successfully
或者其他类似消息。
测试登录接口:
- 在 Postman 中,创建一个新的请求。
- 选择 POST 方法。
- 在 URL 栏中输入:
http://localhost:8080/login
。 - 切换到 Body 选项卡,选择 raw 并设置格式为 JSON。
- 输入以下 JSON 数据进行登录:
{ "username": "my_username", "password": "my_password" }
点击 Send 发送请求。如果登录成功,你应该会收到一个成功的响应,并且返回一个 JWT Token。例如:
{
"token": "your_jwt_token_here"
}
保存下这个 Token,稍后你将需要它来访问需要身份验证的路由。
测试保护的路由(例如,用户资料):
- 在 Postman 中,创建一个新的请求。
- 选择 GET 方法。
- 在 URL 栏中输入:
http://localhost:8080/protected/profile
。 - 在 Headers 选项卡中,添加一个新的头部字段:
- Key:
Authorization
- Value:
Bearer your_jwt_token_here
(这里的your_jwt_token_here
是你从登录接口获得的 JWT Token)
- Key:
- 点击 Send 发送请求。
如果 Token 有效,你将看到包含用户信息的响应(例如用户名、邮箱等)。
6.Postman 的其他功能
Postman 还提供了很多其他功能来帮助你测试 API:
- 保存请求:你可以将请求保存到 Postman 中,方便下次使用。
- 组织请求:可以将请求组织到不同的 Collection 中,以便管理和分类。
- 环境变量:你可以在 Postman 中使用环境变量来动态改变请求的 URL、Token 或其他参数。
- 测试脚本:Postman 还允许你编写 JavaScript 脚本来验证 API 响应或自动化测试。