# Insérer une référence d’API dans votre documentation

GitBook vous permet de générer automatiquement des pages liées aux points de terminaison que vous avez dans votre spécification OpenAPI. Ces pages contiendront des blocs d’opérations OpenAPI, vous permettant, à vous et à vos visiteurs, de tester vos points de terminaison et de les explorer plus en détail à partir des informations trouvées dans la spécification.

{% hint style="success" %}
Les points de terminaison ajoutés à partir de votre spécification continueront d’être mis à jour chaque fois que votre spécification est mise à jour. Consultez la [Mettre à jour votre spécification](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/api-references/add-an-openapi-specification#update-your-specification) section pour plus d’informations.
{% endhint %}

### Créer automatiquement des pages OpenAPI à partir de votre spécification

Après avoir [ajouté votre spécification OpenAPI](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/api-references/openapi/add-an-openapi-specification), vous pouvez générer des pages de points de terminaison en insérant une **Référence OpenAPI** dans la table des matières d’un espace.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FYy8gCqxfaO4xjv2eqiL5%2Fcreate_api_pages%402x.png?alt=media&#x26;token=62b8386b-9fea-4233-b961-b6a1e582411e" alt="A GitBook screenshot showing how to insert API references into the table of contents of a space"><figcaption><p>Insérez des références API dans la table des matières d’un espace.</p></figcaption></figure>

{% stepper %}
{% step %}
**Générer des pages à partir d’OpenAPI**

Dans l’espace où vous souhaitez générer des pages de points de terminaison, cliquez sur le **Ajouter nouveau...** bouton en bas de la [table des matières](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/ressources/gitbook-ui#table-of-contents).

À partir d’ici, cliquez sur **Référence OpenAPI**.
{% endstep %}

{% step %}
**Choisissez votre spécification OpenAPI**

Choisissez votre spécification OpenAPI précédemment téléchargée, puis cliquez sur **Insérer** pour ajouter automatiquement vos points de terminaison à votre espace. Vous pouvez éventuellement choisir d’ajouter une page de modèles faisant référence à tous vos schémas OpenAPI.
{% endstep %}

{% step %}
**Gérez vos opérations API**

GitBook générera automatiquement des pages basées sur votre spécification OpenAPI et sur les balises définies dans sa définition.

Accédez à [structuring-your-api-reference](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/api-references/guides/structuring-your-api-reference "mention") pour en savoir plus sur l’organisation de vos opérations via votre spécification OpenAPI.
{% endstep %}
{% endstepper %}

### Ajouter un bloc OpenAPI individuel

Vous pouvez également ajouter individuellement à vos pages, dans toute votre documentation, des opérations ou des schémas OpenAPI issus de votre spécification.

{% stepper %}
{% step %}
**Ajouter un nouveau bloc OpenAPI**

Ouvrez le sélecteur de blocs en appuyant sur **/**, puis recherchez OpenAPI.
{% endstep %}

{% step %}
**Choisissez votre spécification OpenAPI**

Choisissez votre spécification OpenAPI précédemment téléchargée, puis cliquez sur **Continuer** pour choisir les points de terminaison que vous souhaitez utiliser.
{% endstep %}

{% step %}
**Choisissez les opérations ou les schémas que vous souhaitez insérer**

Sélectionnez les opérations et les schémas que vous voulez insérer dans votre documentation, puis cliquez sur **Insérer**.
{% endstep %}
{% endstepper %}