怎样使用Postman测试Laravel11的API-php教程-PHP中文网

Postman 测试 Laravel 11 API 需正确配置认证头（Authorization: Bearer {token}）、路由前缀（/api）、JSON 格式（Headers 含 Accept/Content-Type: application/json）及禁用 CSRF，确保路由定义在 api.php 并应用 api 中间件组。

怎样使用postman测试laravel11的api

Postman 是测试 Laravel 11 API 最常用、最直观的工具之一。关键在于正确配置请求（尤其是认证、CSRF 和 JSON 格式），并理解 Laravel 11 默认的 API 路由与中间件行为。

1. 确保 Laravel 11 API 路由已正确配置

Laravel 11 默认使用 routes/api.php，所有路由自动加前缀 /api，且默认应用 api 中间件组（含 throttle:api 和无 session/CSRF）。这意味着：

无需手动设置 X-CSRF-TOKEN 或 Cookie 登录（除非你主动启用了 web 中间件）
若用 Sanctum 或 Passport 做 API 认证，需额外携带 token（如 Authorization: Bearer {token}）
检查 config/api.php 中的 throttle 配置，避免测试时被限流（可临时注释或调高限制）

2. Postman 中设置基础请求参数

以 GET 请求 /api/users 为例：

Method：选择 GET
URL：http://your-app.test/api/users（确保域名和端口与本地开发环境一致，如使用 Laravel Sail/Valet/Docker）
Headers 标签页添加：
Accept: application/json
Content-Type: application/json
（Laravel 会据此返回 JSON 响应，而非重定向或视图）

3. 测试带认证的 API（以 Laravel Sanctum 为例）

若你的 API 受 Sanctum 保护（如 auth:sanctum 中间件）：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

先用 Postman 发起登录请求（POST /api/login），Body → raw → JSON，传入 {"email":"test@example.com","password":"password"}
成功后响应中会返回一个 token（或自动在响应头 Authorization 中返回 Bearer token）
后续请求在 Headers 中添加：
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
注意：Sanctum 的 token 是无状态的，不需要刷新，但需确保 sanctum.php 中 stateful 域名包含你的 Postman 请求域名（如 ['localhost', '127.0.0.1']）

4. 测试 POST/PUT/PATCH 请求（发送 JSON 数据）

例如创建用户：

Method：POST
URL：http://your-app.test/api/users
Headers：
Accept: application/json
Content-Type: application/json
Body → raw → JSON：
{ "name": "Alice", "email": "alice@example.com", "password": "password123" }
如果遇到 422 Unprocessable Content，检查响应中的 errors 字段，确认字段名、必填项和验证规则是否匹配