> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-hello-world-quickstart-48843.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage

> Problèmes courants liés aux références d’API

Si vos pages d’API ne s’affichent pas correctement, vérifiez ces problèmes de configuration courants :

<AccordionGroup>
  <Accordion title="Toutes mes pages OpenAPI sont complètement vides">
    Dans ce cas, il est probable que Mintlify ne trouve pas votre document OpenAPI ou que celui-ci soit invalide.

    L’exécution de `mint dev` en local devrait mettre en évidence certains de ces problèmes.

    Pour vérifier que votre document OpenAPI passe la validation :

    1. Rendez-vous sur [ce validateur](https://editor.swagger.io/)
    2. Ouvrez l’onglet « Validate text »
    3. Collez votre document OpenAPI
    4. Cliquez sur « Validate it! »

    Si la zone de texte qui apparaît en dessous a une bordure verte, votre document a réussi la validation.
    C’est exactement le package de validation que Mintlify utilise pour valider les documents OpenAPI ; si votre document
    passe la validation ici, il y a de fortes chances que le problème se situe ailleurs.

    Par ailleurs, Mintlify ne prend pas en charge OpenAPI 2.0. Si votre document utilise cette version de la spécification,
    vous pourriez rencontrer ce problème. Vous pouvez convertir votre document sur [editor.swagger.io](https://editor.swagger.io/) (menu Edit > Convert to OpenAPI 3) :

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/FYO7l_4g6ReiCSAk/images/convert-oas-3.png?fit=max&auto=format&n=FYO7l_4g6ReiCSAk&q=85&s=af1abc18d02cfdce7aaa3782c21a0f70" alt="" width="1454" height="592" data-path="images/convert-oas-3.png" />
    </Frame>
  </Accordion>

  <Accordion title="Une de mes pages OpenAPI est complètement vide">
    Ceci est généralement dû à une faute de frappe dans le champ `openapi` des métadonnées de la page. Assurez-vous
    que la méthode HTTP et le chemin correspondent exactement à la méthode HTTP et au chemin dans le document OpenAPI.

    Voici un exemple de la façon dont cela peut mal se passer :

    ```mdx get-user.mdx
    ---
    openapi: "GET /users/{id}/"
    ---
    ```

    ```yaml openapi.yaml
    paths :
      "/users/{id}":
        get : ...
    ```

    Remarquez que le chemin dans le champ `openapi` se termine par une barre oblique, tandis que le chemin dans le document OpenAPI n’en a pas.

    Un autre problème courant est une erreur dans le nom de fichier. Si vous renseignez un document OpenAPI précis dans le champ `openapi`, assurez-vous que le nom de fichier est correct. Par exemple, si vous avez deux documents OpenAPI `openapi/v1.json` et `openapi/v2.json`, vos métadonnées pourraient ressembler à ceci :

    ```mdx référence-api/v1/utilisateurs/obtenir-utilisateur.mdx
    ---
    openapi: "v1 GET /users/{id}"
    ---
    ```
  </Accordion>

  <Accordion title="Les requêtes depuis le Terrain de jeu API ne fonctionnent pas">
    Si vous avez configuré un domaine personnalisé, le problème peut venir de votre proxy inverse. Par défaut, les requêtes effectuées via le Terrain de jeu API commencent par une requête `POST` vers le chemin `/_mintlify/api/request` sur le site de documentation. Si votre proxy inverse n’autorise que les requêtes `GET`, toutes ces requêtes échoueront. Pour corriger cela, configurez votre proxy inverse pour autoriser les requêtes `POST` vers le chemin `/_mintlify/api/request`.

    Sinon, si votre proxy inverse empêche l’acceptation des requêtes `POST`, vous pouvez configurer Mintlify pour envoyer les requêtes directement à votre backend via le paramètre `api.playground.proxy` dans le fichier `docs.json`, comme expliqué dans la [documentation des paramètres](/fr/settings#param-proxy). Avec cette configuration, vous devrez configurer CORS sur votre serveur, car les requêtes proviendront directement des navigateurs des utilisateurs plutôt que de passer par votre proxy.
  </Accordion>

  <Accordion title="Les entrées de navigation OpenAPI ne génèrent pas de pages">
    Si vous utilisez une configuration de navigation OpenAPI mais que les pages ne se génèrent pas, vérifiez ces problèmes courants :

    1. **Spécification OpenAPI par défaut manquante** : Assurez-vous d’avoir un champ `openapi` défini pour l’élément de navigation :

    ```json {5}
    "navigation": {
      "groups": [
        {
          "group": "Référence de l’API",
          "openapi": "/path/to/openapi.json",
          "pages": [
            "GET /users",
            "POST /users"
          ]
        }
      ]
    }
    ```

    2. **Héritage de la spécification OpenAPI** : Si vous utilisez une navigation imbriquée, assurez-vous que les groupes enfants héritent de la bonne spécification OpenAPI ou définissez la leur.

    3. **Problèmes de validation** : Utilisez `mint openapi-check <path-to-openapi-file>` pour vérifier que votre document OpenAPI est valide.
  </Accordion>

  <Accordion title="Certaines opérations OpenAPI apparaissent dans la navigation, mais d’autres non">
    1. **Opérations masquées** : Les opérations marquées avec `x-hidden: true` dans votre spécification OpenAPI n’apparaîtront pas dans la navigation générée automatiquement.
    2. **Opérations invalides** : Les opérations présentant des erreurs de validation dans la spécification OpenAPI peuvent être ignorées. Vérifiez votre document OpenAPI pour détecter d’éventuelles erreurs de syntaxe.
    3. **Inclusion manuelle vs automatique** : Si vous référencez des endpoints à partir d’une spécification OpenAPI, seules les opérations explicitement référencées apparaîtront dans la navigation. Aucune autre page ne sera ajoutée automatiquement. Cela inclut les opérations référencées dans des éléments de navigation enfants.
  </Accordion>

  <Accordion title="La navigation mixte (pages OpenAPI et MDX) ne fonctionne pas correctement">
    Lors de la combinaison d’opérations OpenAPI avec des pages de documentation classiques dans la navigation :

    1. **Conflits de fichiers** : vous ne pouvez pas avoir à la fois un fichier `MDX` et une entrée de navigation pour la même opération. Par exemple, si vous avez `get-users.mdx`, n’ajoutez pas également « GET /users » dans votre navigation. Si vous devez avoir un fichier qui partage le nom d’une opération, utilisez l’extension `x-mint` sur le point de terminaison afin que le href pointe vers un autre emplacement.
    2. **Résolution des chemins** : les entrées de navigation qui ne correspondent pas à des opérations OpenAPI seront interprétées comme des chemins de fichiers. Assurez-vous que vos fichiers `MDX` existent aux emplacements attendus.
    3. **Sensibilité à la casse** : la correspondance des opérations OpenAPI est sensible à la casse. Assurez-vous que les méthodes HTTP sont en majuscules dans les entrées de navigation.
  </Accordion>
</AccordionGroup>