Entente

Paid APISelf-hostedWeb

What Entente is

Entente is a free, open-source contract testing platform that starts with OpenAPI specifications and uses recorded API interactions to check consumer-provider compatibility. In CI, consumer interactions can be recorded and replayed against provider services; providers can verify their implementations against those interactions. Consumers can test through mock servers generated from provider specifications, using dynamic or fixture-based responses, or intercept real HTTP requests while still calling the actual API. Interceptor mode supports fetch and Node.js HTTP clients, while mock server mode works with any HTTP client. Teams can centrally manage and reuse fixtures across consumers, with an approval workflow. Entente documents GitHub Actions workflows for automated testing and deployment-safety checks that can block deployments 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. The service can be self-hosted on Cloudflare Workers with Neon PostgreSQL persistence. CI integration requires an Entente API key, and all packages require Node.js 20 or later.

Who it suits

It suits consumer and provider teams in microservices architectures that want contract checks in CI/CD. Teams can use mock-server or request-interception workflows and can self-host the central service.

What it does well

Contracts start from OpenAPI specifications.
Records and replays consumer interactions in CI.
Supports reusable, centrally managed fixtures.
GitHub Actions workflows include deployment checks.
Self-hosting is documented.

What to know first

Requires Node.js 20 or later.
GitHub Actions integration requires an API key.
Interceptor mode supports only fetch and Node.js HTTP clients.

Getting started

Open the Entente website
Install Node.js 20 or later for the packages
Define contracts with OpenAPI specifications
Set up consumer and provider libraries or the CLI
Configure an Entente API key as a repository secret
Add the documented GitHub Actions workflows

Verdict

Entente provides OpenAPI-based contract testing with recorded interactions, fixture management, and CI deployment checks. Teams should account for its runtime requirement and configure the API key for CI.

Questions

Is Entente free?

Yes. Entente is listed as free and open source.

Which contract format does Entente use?

Entente uses OpenAPI specifications.

Can Entente be self-hosted?

Yes. The service can run on Cloudflare Workers with Neon PostgreSQL for persistence.

How does Entente integrate with CI?

It documents GitHub Actions workflows for contract testing and deployment-safety checks. The workflows require an Entente API key stored as a repository secret.

What clients work with interceptor mode?

The documented interceptor supports fetch and Node.js HTTP clients. Mock server mode works with any HTTP client.

Facts from Entente's own pages

API key: The GitHub Actions guide requires an Entente API key and recommends storing it as a repository secret. · docs.entente.dev, 8 Oct 2026
Authentication: The documentation configures an Entente API key as a required secret for CI integration. · docs.entente.dev, 8 Oct 2026
Automatic recording: CI environments can record consumer interactions and replay them against the provider service. · docs.entente.dev, 8 Oct 2026
CI integration: Entente documents GitHub Actions workflows for contract testing and deployment safety checks. · docs.entente.dev, 8 Oct 2026
Consumer and provider testing: Entente verifies provider implementations against real recorded consumer interactions. · docs.entente.dev, 8 Oct 2026
Consumer modes: Consumers can use isolated mock servers with fixtures or intercept real HTTP requests while calling actual APIs. · docs.entente.dev, 8 Oct 2026
Deployment checks: The CLI can check whether a consumer or provider version is safe to deploy to an environment. · docs.entente.dev, 8 Oct 2026
Fixture management: Teams can record and reuse fixtures across consumers with centralized management and approval. · docs.entente.dev, 8 Oct 2026
Fixtures: Entente supports centrally managed fixtures, reuse across consumers, and an approval workflow. · docs.entente.dev, 8 Oct 2026
Integration: Entente documents GitHub Actions workflows for automated contract testing in CI/CD. · docs.entente.dev, 8 Oct 2026
Intended users: The documentation provides separate workflows for consumer and provider services in a microservices architecture. · docs.entente.dev, 8 Oct 2026
Interaction recording: In CI, consumer interactions can be recorded and replayed against provider services. · docs.entente.dev, 8 Oct 2026
Interceptor limitation: The documented interceptor supports fetch and http module clients; mock server mode works with any HTTP client. · docs.entente.dev, 8 Oct 2026
Mock servers: Consumer tests can use mock servers generated from provider OpenAPI specifications, with dynamic or fixture-based responses. · docs.entente.dev, 8 Oct 2026
OpenAPI-first: Contracts start with OpenAPI specifications. · docs.entente.dev, 8 Oct 2026
Product: Entente is a schema-first contract testing platform that combines OpenAPI specifications with recorded API interactions. · docs.entente.dev, 8 Oct 2026
Provider verification: Providers can verify their implementations against recorded consumer interactions. · docs.entente.dev, 8 Oct 2026
Request interception: Interceptor mode supports fetch and Node.js HTTP clients, and records interactions while allowing calls to reach real APIs. · docs.entente.dev, 8 Oct 2026
Runtime requirement: The project repository lists Node.js 20 or later as required for all packages. · github.com, 8 Oct 2026
Self-hosting: Entente says users can run the service themselves on Cloudflare Workers with Neon PostgreSQL for persistence. · docs.entente.dev, 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. · docs.entente.dev, 8 Oct 2026

Where Entente stands on Freedom251

Contract Testing Tools#21 of 22