Entente
Entente is an open-source contract testing platform that uses OpenAPI specifications alongside recorded API interactions.
What Entente is
Entente is an open-source contract testing platform that uses OpenAPI specifications alongside recorded API interactions. It is designed for consumer and provider services in a microservices architecture. Consumer interactions can be recorded in CI and replayed against provider services to check whether implementations match actual consumer behavior. Consumer tests can instead use mock servers generated from provider specifications, with dynamic or fixture-based responses; interceptor mode records requests while they reach real APIs.
Teams can centrally manage fixtures, reuse them across consumers, and approve them through a workflow. Entente documents GitHub Actions workflows for contract tests and deployment safety checks, which can block a deployment when requirements are unmet. Its documented components include TypeScript consumer and provider libraries, fixture utilities, a CLI, and a central service with a Hono API and React UI. Teams can self-host the service on Cloudflare Workers with Neon PostgreSQL persistence. CI integration requires an Entente API key, and all packages require Node.js 20 or later. Interceptor mode supports fetch and Node.js HTTP clients; mock server mode works with any HTTP client.
Good
- Contracts are based on OpenAPI specifications.
- Fixtures can be centrally managed and reused.
- GitHub Actions workflows support CI contract checks.
- Teams can self-host the central service.
Watch out
- All packages require Node.js 20 or later.
- CI integration requires an Entente API key.
- Interceptor mode supports fetch and Node.js HTTP clients.
Who it suits
Entente suits teams with consumer and provider services that want to verify API contracts using OpenAPI specifications and recorded interactions. It supports hosted web and API use as well as self-hosting.
Verdict
Entente combines OpenAPI-based mocks, recorded interactions, and provider verification, with workflows for deployment checks. Teams should account for its runtime requirement and API-key setup for CI.
The facts
Each one read from Entente's own pages, with the date it was checked.
What it does
- API key
- The GitHub Actions guide requires an Entente API key and recommends storing it as a repository secret.checked 8 Oct 2026
- Authentication
- The documentation configures an Entente API key as a required secret for CI integration.checked 8 Oct 2026
- Automatic recording
- CI environments can record consumer interactions and replay them against the provider service.checked 8 Oct 2026
- CI integration
- Entente documents GitHub Actions workflows for contract testing and deployment safety checks.checked 8 Oct 2026
- Consumer and provider testing
- Entente verifies provider implementations against real recorded consumer interactions.checked 8 Oct 2026
- Consumer modes
- Consumers can use isolated mock servers with fixtures or intercept real HTTP requests while calling actual APIs.checked 8 Oct 2026
- Deployment checks
- The CLI can check whether a consumer or provider version is safe to deploy to an environment.checked 8 Oct 2026
- Fixture management
- Teams can record and reuse fixtures across consumers with centralized management and approval.checked 8 Oct 2026
- Fixtures
- Entente supports centrally managed fixtures, reuse across consumers, and an approval workflow.checked 8 Oct 2026
- Integration
- Entente documents GitHub Actions workflows for automated contract testing in CI/CD.checked 8 Oct 2026
- Intended users
- The documentation provides separate workflows for consumer and provider services in a microservices architecture.checked 8 Oct 2026
- Interaction recording
- In CI, consumer interactions can be recorded and replayed against provider services.checked 8 Oct 2026
- Interceptor limitation
- The documented interceptor supports fetch and http module clients; mock server mode works with any HTTP client.checked 8 Oct 2026
- Mock servers
- Consumer tests can use mock servers generated from provider OpenAPI specifications, with dynamic or fixture-based responses.checked 8 Oct 2026
- OpenAPI-first
- Contracts start with OpenAPI specifications.checked 8 Oct 2026
- Product
- Entente is a schema-first contract testing platform that combines OpenAPI specifications with recorded API interactions.checked 8 Oct 2026
- Provider verification
- Providers can verify their implementations against recorded consumer interactions.checked 8 Oct 2026
- Request interception
- Interceptor mode supports fetch and Node.js HTTP clients, and records interactions while allowing calls to reach real APIs.checked 8 Oct 2026
- Runtime requirement
- The project repository lists Node.js 20 or later as required for all packages.checked 8 Oct 2026
- Self-hosting
- Entente says users can run the service themselves on Cloudflare Workers with Neon PostgreSQL for persistence.checked 8 Oct 2026
- Technology
- The documented architecture includes a TypeScript consumer library, provider library, fixture utilities, CLI, and central service with a Hono API and React UI.checked 8 Oct 2026
Alternatives to Entente
- 1
Karate
Free planOpen sourceAPIExtensionLinuxmacOS8.2From $100 a year - 2
PactFlow
Free planWebAPILinuxSelf-hosted7.6From $115.42 a month - 3
Pact
Free planAPILinuxmacOSSelf-hosted7.5From $115.42 a month - 4
Microcks
Free planWebAPIExtensionLinux7.2Free plan - 5
oasdiff
Free planWebAPILinuxmacOS7.2From $100 a month - 6
Confluent Cloud
Free planWebAPILinux7.1From $385 a month