api-testing

API Testing

When to Use

• Testing REST API endpoints for correct responses
• Writing declarative, repeatable HTTP test suites
• Chaining HTTP requests (authenticate → create → verify)
• Probing multiple URLs for availability, status codes, or headers
• Validating response bodies, headers, and status codes with assertions

Tools

Patterns

Hurl: Simple GET with status assertion

Create a .hurl file:

GET http://localhost:3000/api/health
HTTP 200
[Asserts]
jsonpath "$.status" == "ok"

Run it:

hurl health.hurl

Hurl: POST with JSON body and response validation

POST http://localhost:3000/api/users
Content-Type: application/json
{
  "name": "Alice",
  "email": "alice@example.com"
}
HTTP 201
[Asserts]
jsonpath "$.id" isInteger
jsonpath "$.name" == "Alice"

Hurl: Chained requests (auth → create → verify)

# Step 1: Login
POST http://localhost:3000/api/auth/login