← Docs
Recipe

Smoke test generator from API docs

Turn your OpenAPI spec into a runnable smoke test suite in under 60 seconds.

Ingredients

  • OpenAPI 3.x spec (JSON or YAML)
  • Meridian CLI v2.4+
  • Target environment base URL

Steps

  1. Feed the spec.
    meridian smoke init --spec ./openapi.yaml
  2. Set the target.
    meridian smoke target https://staging.api.example.com
  3. Generate the suite. Meridian walks every endpoint, extracts happy-path params, and writes a test per route.
  4. Run it.
    meridian smoke run

Output

A smoke/ directory with one file per endpoint. Each test asserts a 2xx status and validates the response shape against the spec schema.

Pro tip

Pipe the output into your CI with --junit smoke.xml and block deploys on failure.