Entente

Spec sheet

Product

Entente is a schema-first contract testing platform that combines OpenAPI specifications with recorded API interactions.Read 8 Oct 2026 · docs.entente.dev

Intended users

Entente provides workflows and guides for both API consumers and providers working across services.Read 8 Oct 2026 · docs.entente.dev

API key

The GitHub Actions guide requires an Entente API key and recommends storing it as a repository secret.Read 8 Oct 2026 · docs.entente.dev

Authentication

The documentation configures an Entente API key as a required secret for CI integration.Read 8 Oct 2026 · docs.entente.dev

Automatic recording

CI environments can record consumer interactions and replay them against the provider service.Read 8 Oct 2026 · docs.entente.dev

CI integration

Entente documents GitHub Actions workflows for contract testing and deployment safety checks.Read 8 Oct 2026 · docs.entente.dev

Consumer and provider testing

Entente verifies provider implementations against real recorded consumer interactions.Read 8 Oct 2026 · docs.entente.dev

Consumer modes

Consumers can use isolated mock servers with fixtures or intercept real HTTP requests while calling actual APIs.Read 8 Oct 2026 · docs.entente.dev

Deployment checks

The CLI can check whether a consumer or provider version is safe to deploy to an environment.Read 8 Oct 2026 · docs.entente.dev

Fixture management

Teams can record and reuse fixtures across consumers with centralized management and approval.Read 8 Oct 2026 · docs.entente.dev

Fixtures

Entente supports centrally managed fixtures, reuse across consumers, and an approval workflow.Read 8 Oct 2026 · docs.entente.dev

Integration

Entente documents GitHub Actions workflows for automated contract testing in CI/CD.Read 8 Oct 2026 · docs.entente.dev

Interaction recording

In CI, consumer interactions can be recorded and replayed against provider services.Read 8 Oct 2026 · docs.entente.dev

Interceptor limitation

The documented interceptor supports fetch and http module clients; mock server mode works with any HTTP client.Read 8 Oct 2026 · docs.entente.dev

Mock servers

Consumer tests can use mock servers generated from provider OpenAPI specifications, with dynamic or fixture-based responses.Read 8 Oct 2026 · docs.entente.dev

OpenAPI-first

Contracts start with OpenAPI specifications.Read 8 Oct 2026 · docs.entente.dev

Provider verification

Providers can verify their implementations against recorded consumer interactions.Read 8 Oct 2026 · docs.entente.dev

Request interception

Interceptor mode supports fetch and Node.js HTTP clients, and records interactions while allowing calls to reach real APIs.Read 8 Oct 2026 · docs.entente.dev

Runtime requirement

The project repository lists Node.js 20 or later as required for all packages.Read 8 Oct 2026 · github.com

Self-hosting

Entente says users can run the service themselves on Cloudflare Workers with Neon PostgreSQL for persistence.Read 8 Oct 2026 · docs.entente.dev

Technology

The documented architecture includes a TypeScript consumer library, provider library, fixture utilities, CLI, and central service with a Hono API and React UI.Read 8 Oct 2026 · docs.entente.dev

Where Specifiction places it

• Contract Testing Tools#18 of 227.4