Connexions¶

Connexions is a mock server generator for OpenAPI specifications.
It allows you to define multiple APIs and generate meaningful mock responses automatically.
You can also define static responses for any arbitrary path.

Goals¶

provide a simple tool to work with API mocks
combine multiple APIs into one server
generate meaningful responses

Features¶

Multiple APIs on one server - each spec becomes a service with its own URL prefix
Upstream proxy with circuit breaker - forward to real backends with fallback to mocks
Latency & error simulation - test how your app handles delays and failures
Custom middleware - modify requests/responses on the fly
Response caching - cache GET responses for consistency
Request validation - validate against OpenAPI spec

Real-World Validation¶

Connexions continuously generates and validates data against 2,200+ real-world OpenAPI specifications from cubahno/specs:

Total: 2215 services, 98464 endpoints
✅ Success: 98464  ❌ Fails: 0

Simple start¶

docker run -it --rm \
  -p 2200:2200 \
  -v connexions:/app/resources/data \
  cubahno/connexions api

Read full documentation at cubahno.github.io/connexions.

OpenAPI Specification

License¶

Licensed under the MIT License