HTTPTestsAutomated HTTP Integration Testing

Quick Example ​

Add a test suite to your repository:

# .httptests/config.yml
mock:
  network_aliases:
    - backend

nginx:
  environment:
    ENV_VAR: value

// .httptests/test.json
{
  "hosts": {
    "api.example.com": [
      {
        "paths": ["/health"],
        "method": "GET",
        "expectedStatus": 200,
        "expectedResponseHeaders": [
          ["Content-Type", "application/json"]
        ]
      }
    ]
  }
}

# .github/workflows/test.yml
name: HTTPTests
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: serviceguards-com/httptests-action@v2
        with:
          httptests-directory: .

That's it! Your HTTP integration tests will now run on every push and pull request.

Why HTTPTests? ​

Use Cases ​

API Testing ​

Test REST APIs, GraphQL endpoints, and webhooks with comprehensive assertions on status codes, headers, and response bodies.

Nginx/Proxy Validation ​

Validate reverse proxy configurations, header transformations, routing rules, and upstream forwarding behavior.

Microservices Testing ​

Test service-to-service communication, load balancing, service discovery, and API gateway configurations.

Load Balancer Testing ​

Verify load balancer behavior, health checks, failover scenarios, and request distribution.

Ready to Get Started? ​

Get Started →View Examples →