L’URL pointe vers un hôte privé ou de bouclage, ou redirige vers celui-ci. Faites pointer l’URL vers un hôte accessible publiquement.
Corriger les erreurs de source de la référence API
Lorsqu’une référence API ne parvient pas à récupérer, actualiser ou traiter sa spécification, l’une des erreurs ci-dessous s’affiche. Repérez votre message, appliquez la correction, puis actualisez à nouveau depuis l’onglet Source de la référence. La procédure pour ouvrir une référence et l’actualiser est décrite dans Actualiser les sources d’une référence API.
Erreurs d’URL de spécification
Hôte de l’URL de spécification de l’API bloqué : <hostname>
Impossible de résoudre l’hôte de l’URL de spécification de l’API : <hostname>
Le nom d’hôte ne peut pas être résolu. Vérifiez que l’URL ne contient pas de faute de frappe.
Seules les URL de spécification d’API HTTP(S) sont autorisées
L’URL utilise un protocole autre que HTTP ou HTTPS. Utilisez une URL HTTP ou HTTPS.
L’URL de spécification de l’API ne doit pas contenir d’identifiants intégrés
L’URL contient un nom d’utilisateur et un mot de passe. Supprimez les identifiants de l’URL.
Impossible de récupérer la spécification depuis <host> (HTTP <status>)
Le serveur a renvoyé une erreur HTTP, par exemple 410 Gone. Il s’agit du message affiché dans l’onglet Source. Vérifiez que l’URL fournit toujours la spécification.
Impossible de récupérer la spécification de l’API (trop de redirections, 5 maximum)
L’URL redirige plus de cinq fois. Faites pointer l’URL directement vers la spécification.
L’URL n’a renvoyé ni document de spécification ni schéma GraphQL. Faites-la pointer vers un fichier OpenAPI, un fichier SDL GraphQL ou un endpoint GraphQL avec l’introspection activée.
L’URL a fourni un contenu que nous ne pouvons pas lire comme une spécification. Faites-la pointer vers un fichier OpenAPI, un fichier SDL GraphQL ou un endpoint GraphQL avec l’introspection activée.
Erreurs de taille de la spécification
La spécification de l’API dépasse la limite de 15 Mo.
Le fichier de spécification fait plus de 15 Mo. Réduisez sa taille à moins de 15 Mo, puis réessayez.
Erreurs GitHub
Impossible de s’authentifier auprès de GitHub. Essayez de reconnecter l’intégration.
La connexion GitHub ne peut plus s’authentifier. Reconnectez l’intégration GitHub, puis actualisez à nouveau. Consultez Intégration GitHub.
Le chemin GitHub doit pointer vers un fichier
Le chemin configuré pointe vers un répertoire. Faites-le pointer vers le fichier de spécification lui-même.
Fichier introuvable dans le dépôt GitHub sur cette référence
Le fichier n’existe pas sur la référence configurée. Vérifiez le chemin et la référence, ou déplacez le fichier et mettez à jour la référence.
La connexion GitHub ne peut pas lire ce dépôt
La connexion GitHub n’a pas accès au dépôt. Accordez à la connexion l’accès au dépôt dans GitHub, puis actualisez à nouveau.
Impossible de lire ce fichier depuis GitHub.
Il s’agit du message de remplacement affiché lorsque le fichier n’a pas pu être lu. Vérifiez la connexion, le chemin et la référence, puis actualisez à nouveau.
Échecs du traitement
Échec du traitement
Une erreur s’est produite lors de la lecture et de l’indexation de la spécification. La référence reste modifiable : remplacez donc la spécification et réessayez.