Vérificateur de diff de contrat API

Examen multi-contrats privés

Comparez les versions OpenAPI, AsyncAPI ou GraphQL et expliquez les changements majeurs localement.

Format du contrat

Contrat de base

Le dernier contrat libéré ou accepté.

Contrat actuel

Le contrat du candidat à réviser.

openapi: 3.1.0
info: { title: Pet API, version: 2.0.0 }
paths:
  /pets/{id}:
    get:
      summary: Get one pet
      security: [{ bearerAuth: [] }]
      parameters:
        - { name: id, in: path, required: true, schema: { type: integer } }
        - { name: locale, in: query, required: true, schema: { type: string } }
      responses:
        '200':
          description: Pet
          content: { application/json: { schema: { $ref: '#/components/schemas/Pet' } } }
  /pets:
    post:
      requestBody:
        required: true
        content: { application/json: { schema: { $ref: '#/components/schemas/PetInput' } } }
      responses: { '201': { description: Created } }
components:
  securitySchemes: { bearerAuth: { type: http, scheme: bearer } }
  schemas:
    Pet:
      type: object
      required: [id, name]
      properties: { id: { type: string }, name: { type: string }, status: { type: string, enum: [active, pending] } }
    PetInput:
      type: object
      required: [name]
      properties: { name: { type: string } }

Mode d’emploi

01
Charger les deux contrats
Coller ou ouvrir un contrat OpenAPI, AsyncAPI ou GraphQL actuel.
02
Examiner la compatibilité
Inspecter l'opération, l'entrée, la réponse, la sécurité et le schéma change avec les preuves avant et après.
03
Planifiez la sortie
Marquer les exceptions examinées et exporter un journal de changement, des données de vérification ou une décision d'IC.

Questions fréquentes

Les contrats API sont-ils téléchargés?

Non. Parsing, normalisation, comparaison et exportation s'exécutent dans ce navigateur.

Quels sont les contrats soutenus?

OpenAPI 3.x, les structures communes AsyncAPI 2 et 3 et GraphQL SDL sont prises en charge.

Cela remplace-t-il les essais contractuels?

Non. La comparaison statique des contrats est une couche d'examen précoce; les validateurs d'exécution et les tests de consommation demeurent nécessaires.

Les références externes sont-elles récupérées?

Non. Les références des composantes locales sont résolues lorsqu'elles sont prises en charge; les références à distance sont déclarées comme une limite d'examen.

Poursuivez avec d’autres utilitaires web ciblés.

Tous les outils

Mode d’emploi

Charger les deux contrats

Examiner la compatibilité

Planifiez la sortie

Questions fréquentes

Outils associés

Éditeur OpenAPI & Testeur de Contrats

Explorateur de Requêtes & Schémas GraphQL

Éditeur & Vérificateur AsyncAPI