Entente
entente.dev
- Web
- API
- Self-hosted
What Entente is
Entente is a free, open-source contract testing platform built around OpenAPI specifications and recorded API interactions. It targets consumer and provider services in microservices architectures. Consumer interactions can be captured in CI and replayed against provider services to verify implementations against real usage. Consumer tests can use isolated mock servers generated from provider OpenAPI specifications, with dynamic or fixture-based responses, or intercept requests while calls reach real APIs. Interceptor mode supports fetch and Node.js HTTP clients, while mock server mode works with any HTTP client. Teams can centrally manage, reuse, and approve fixtures across consumers. Entente documents GitHub Actions workflows for contract testing and deployment-safety checks, including blocking deployments when requirements are unmet. The documented system includes TypeScript libraries, fixture utilities, a CLI, and a central Hono API with React UI. Self-hosting uses Cloudflare Workers and Neon PostgreSQL; Node.js 20 or later is required.
Who it suits
Entente suits development teams testing API contracts between consumers and providers in microservices. It is especially relevant to teams using OpenAPI, GitHub Actions, and self-hosted infrastructure.
Good to know, and what to watch
- Open-source and free
- Uses recorded consumer interactions
- Supports reusable approved fixtures
- Offers mock and interceptor modes
- Includes GitHub Actions workflows
- Node.js 20 or later is required
- Interceptor mode supports only fetch and Node.js HTTP clients
- CI integration requires an Entente API key
The verdict
Entente connects OpenAPI contracts with observed consumer behavior, giving teams mock and real-request testing options. Its CI workflows and self-hosting support fit engineering teams managing contract checks in their own pipelines.
What the maker publishes
- API key
- The GitHub Actions guide requires an Entente API key and recommends storing it as a repository secret. source
- Authentication
- The documentation configures an Entente API key as a required secret for CI integration. source
- Automatic recording
- CI environments can record consumer interactions and replay them against the provider service. source
- CI integration
- Entente documents GitHub Actions workflows for contract testing and deployment safety checks. source
- Consumer and provider testing
- Entente verifies provider implementations against real recorded consumer interactions. source
- Consumer modes
- Consumers can use isolated mock servers with fixtures or intercept real HTTP requests while calling actual APIs. source
- Deployment checks
- The documented workflow checks deployment safety and can block deployment when requirements are not met. source
- Deployment checks
- The CLI can check whether a consumer or provider version is safe to deploy to an environment. source
- Fixture management
- Teams can record and reuse fixtures across consumers with centralized management and approval. source
- Fixtures
- Entente supports centrally managed fixtures, reuse across consumers, and an approval workflow. source
- Integration
- Entente documents GitHub Actions workflows for automated contract testing in CI/CD. source
- Intended users
- The documentation provides separate workflows for consumer and provider services in a microservices architecture. source
- Intended users
- Entente provides workflows and guides for both API consumers and providers working across services. source
- Interaction recording
- In CI, consumer interactions can be recorded and replayed against provider services. source
- Interceptor limitation
- The documented interceptor supports fetch and http module clients; mock server mode works with any HTTP client. source
- Mock servers
- Consumer tests can use mock servers generated from provider OpenAPI specifications, with dynamic or fixture-based responses. source
- OpenAPI-first
- Contracts start with OpenAPI specifications. source
- Product
- Entente is a schema-first contract testing platform that combines OpenAPI specifications with recorded API interactions. source
- Provider verification
- Providers can verify their implementations against recorded consumer interactions. source
- Request interception
- Interceptor mode supports fetch and Node.js HTTP clients, and records interactions while allowing calls to reach real APIs. source
- Runtime requirement
- The project repository lists Node.js 20 or later as required for all packages. source
- Self-hosting
- Entente says users can run the service themselves on Cloudflare Workers with Neon PostgreSQL for persistence. source
- Technology
- The documented architecture includes a TypeScript consumer library, provider library, fixture utilities, CLI, and central service with a Hono API and React UI. source
Checked against the maker's pages on 8 Oct 2026.