Postman

Postman 是一个非常流行的 API 调试工具,它可以帮助你在没有前端界面的情况下直接测试后端的 API。以下是使用 Postman 的基本步骤和一些常见的操作。

一、安装和初步设置

  1. 安装 Postman: 访问 Postman 官网,下载并安装适用于你的操作系统的版本。

    https://www.postman.com/downloads/

  2. 注册和登录: 安装完成后,可以选择注册一个 Postman 账户(也可以选择跳过)。

二、创建和发送请求

  1. 创建一个新请求:
    • 打开 Postman,点击左上角的 “+” 按钮,创建一个新的请求。
    • 选择请求类型(GET、POST、PUT、DELETE等),在左上角的下拉菜单中选择。
    • 在请求栏输入 API 的 URL,例如 http://localhost:3000/user/account/token/
  2. 设置请求参数:
    • GET 请求: 直接在 URL 后面添加查询参数,例如 ?id=1

    • POST 请求: 在 “Body” 选项卡中选择 “raw”,并选择 JSON 格式,输入请求体数据,例如:

      {
      
        "username": "zw",
      
        "password": "123456"
      
      }
      
  3. 添加请求头(Headers):
    • “Headers” 选项卡中,你可以设置请求头,例如 Content-Type 和 Authorization。示例:
      • Key: Authorization
      • Value: Bearer your_token_here
    • 你还可以设置 Content-Typeapplication/json
  4. 发送请求:
    • 设置完成后,点击 “Send” 按钮,Postman 将发送请求到服务器。
    • 你可以在下方看到服务器返回的响应数据、状态码、时间等信息。

三、查看和分析响应

  1. 响应数据:
    • 在下方的响应区,你可以查看服务器返回的响应数据。Postman 会自动格式化 JSON 数据,便于查看。
    • 你还可以看到响应的状态码(例如 200 OK、404 Not Found)以及响应时间。
  2. 响应头(Headers):
    • 点击 “Headers” 选项卡可以查看服务器返回的响应头,了解服务器的返回信息。

四、高级功能

  1. 环境变量:
    • 你可以创建环境变量(Environment Variables)来管理不同环境的 URL、Token 等配置。点击右上角的 齿轮图标,选择 “Manage Environments”,然后添加环境变量,例如:
      • 变量名:baseUrl
      • 值:http://localhost:3000
    • 在请求的 URL 中,可以使用变量,如:{{baseUrl}}/user/account/token/
  2. Postman Collections:
    • 你可以将多个请求保存到一个 Collection(集合) 中,便于组织和管理项目。点击左侧 “Collections”,创建一个新集合,然后将请求添加进去。
    • 通过集合,你可以快速回顾和执行多个请求。
  3. Pre-request Script 和 Tests:
    • 在每个请求中,你可以编写 JavaScript 脚本来执行前置操作或测试。例如,在发送请求之前,你可以自动生成 Token,或者在接收到响应后,验证返回数据。

五、实战操作示例

示例:测试登录接口

  1. 创建一个 POST 请求,URL 设置为 http://localhost:3000/user/account/login/

  2. 在 Body 中选择 raw,并选择 JSON 格式,输入以下内容:

    {
    
      "username": "zw",
    
      "password": "123456"
    
    }
    
  3. 设置 Headers 中的 Content-Type 为 application/json

  4. 点击 Send 发送请求,并查看下方的响应结果。

六、使用 Postman 调试常见问题

  1. 请求失败:检查 URL 是否正确、端口号是否一致。
  2. 404 Not Found:确认路由路径是否正确,API 路径拼写无误。
  3. 500 Internal Server Error:查看响应中的错误信息,或在后端查看日志进行排查。
  4. 认证失败:检查请求头中的 Token 是否有效,或重新获取 Token。

通过这些步骤和操作,你可以用 Postman 高效地调试后端 API,无需依赖前端连接测试。


项目分区导航Http请求 以及 Springboot注解 ⬅️ | 02-Postman | ➡️ JWT验证