> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/api-references/guides/openapi-layouts.md).

# Mises en page OpenAPI

Lorsque vous insérez un **Référence OpenAPI**, GitBook peut organiser les opérations de deux façons.

Choisissez la présentation qui correspond à la façon dont vous voulez que les utilisateurs parcourent votre API.

### Accédez à ce paramètre

Pour choisir une présentation :

1. Dans votre section, cliquez sur **Ajouter...** → **Référence OpenAPI**. Vous pouvez également modifier une référence OpenAPI existante.
2. Choisissez votre spécification OpenAPI.
3. Dans **Structure de la page**, sélectionnez **Une page par tag** ou **Une page par opération**.

Pour le processus de configuration complet, consultez [Insérer une référence d'API dans votre documentation](/docs/documentation/fr/api-references/openapi/insert-api-reference-in-your-docs.md).

### Mises en page disponibles

GitBook prend en charge deux mises en page :

* **Une page par tag** crée une page pour chaque tag. Chaque page répertorie toutes les opérations portant ce tag.
* **Une page par opération** crée une page pour chaque opération. GitBook regroupe ces pages par tag dans la table des matières.

### Exemple d'entrée

Les deux mises en page partent des mêmes données OpenAPI :

{% code title="openapi.yaml" %}

```yaml
paths:
  /users:
    get:
      tags:
        - users
      summary: Lister les utilisateurs
    post:
      tags:
        - users
      summary: Créer un utilisateur
```

{% endcode %}

### Une page par tag

Utilisez cette mise en page lorsque chaque tag représente une section claire de votre API.

Elle fonctionne bien lorsque vous voulez des pages de présentation, moins d'entrées dans la navigation et des points de terminaison associés sur la même page.

Avec cette mise en page, les deux opérations apparaissent sur la même page générée pour le `users` tag.

### Une page par opération

Utilisez cette mise en page lorsque vous voulez des liens directs vers des points de terminaison individuels.

Elle fonctionne bien pour les grandes API, ou lorsque chaque point de terminaison a besoin de sa propre page dans la navigation.

Avec cette mise en page, GitBook crée une page pour `GET /users` et une page pour `POST /users`. Les deux pages apparaissent sous le `users` groupe de tags.

### Recommandation rapide

Choisissez **Une page par tag** pour les petites API, ou lorsque chaque tag correspond à une section claire.

Choisissez **Une page par opération** pour les grandes API, ou lorsque vous voulez une page dédiée pour chaque point de terminaison.

### Contrôlez la navigation générée

Dans les deux mises en page, GitBook utilise vos tags OpenAPI pour organiser la référence.

Pour contrôler l'ordre, la hiérarchie, les titres des pages, les icônes et les descriptions, consultez [Structurer votre référence d'API](/docs/documentation/fr/api-references/guides/structuring-your-api-reference.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/api-references/guides/openapi-layouts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.