# Ajouter une spécification OpenAPI

Si vous disposez d’une spécification OpenAPI, vous pouvez l’ajouter à votre organisation en téléversant directement le fichier, en établissant un lien vers une URL hébergée, ou en utilisant le [GitBook CLI](https://gitbook.com/docs/developers/integrations/reference).

<figure><img src="/files/0fca8ea2eb3334ee913245c383017739f735f5cd" alt="A GitBook screenshot showing the modal for generating API docs automatically"><figcaption></figcaption></figure>

### Comment ajouter une spécification

1. Ouvrez le **OpenAPI** section dans la barre latérale
2. Cliquez sur **Ajouter une spécification**
3. Donnez un nom à votre spécification. Cela permet de l’identifier, surtout si vous gérez plusieurs spécifications
4. Choisissez l’une des options suivantes :
   * Téléverser un fichier (par ex. *openapi.yaml*)
   * Saisissez une URL vers une spécification hébergée
   * Utiliser la CLI pour publier la spécification

<figure><img src="/files/bf77749eaadadf8901e6bde1ec71150656f7af5e" alt="A GitBook screenshot showing the Add an OpenAPI specification modal"><figcaption><p>fenêtre modale d’ajout d’une spécification OpenAPI.</p></figcaption></figure>

### Mettre à jour votre spécification

Vous pouvez mettre à jour votre spécification OpenAPI à tout moment à l’aide de l’interface GitBook ou de la CLI, quelle que soit la manière dont elle a été ajoutée à l’origine.

#### Dans l’application GitBook

Dans le panneau OpenAPI :

* Si votre spécification est liée à une URL :
  * GitBook vérifie automatiquement les mises à jour **toutes les 6 heures**.
  * Pour récupérer les mises à jour immédiatement, cliquez sur **Vérifier les mises à jour**.
* Si votre spécification a été téléversée sous forme de fichier :
  * Cliquez sur **Mettre à jour** pour téléverser une nouvelle version.
* Vous pouvez passer d’une source Fichier à une source URL en cliquant sur **Modifier** dans le menu des actions du fil d’Ariane.

#### Avec la CLI

Utilisez la même commande pour mettre à jour votre spécification :

```bash
gitbook openapi publish --spec api-spec-name --organization organization_id <path-or-url>
```

Vous pouvez également utiliser la CLI pour **Vérifier les mises à jour** en exécutant la commande de publication sur la même URL.

Lisez notre [Intégration avec CI/CD](/docs/documentation/fr/api-references/guides/support-for-ci-cd-with-api-blocks.md) guide pour apprendre à automatiser la mise à jour de votre spécification.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/api-references/openapi/add-an-openapi-specification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.