Remplacer une spécification d’API
Le remplacement de la spécification fait basculer une référence d’API vers une nouvelle source : un fichier importé, une URL ou un dépôt GitHub. La référence repasse à l’état de traitement et est réindexée à partir de la nouvelle spécification. Vos choix de remplacement et de mise en page sont conservés.
Remplacer la spécification
Accédez au Centre d’aide dans le tableau de bord, puis cliquez sur la référence d’API dans l’arborescence du contenu.
Dans le volet des détails, sélectionnez l’onglet Source.
Cliquez sur Remplacer la spécification.
Choisissez le type de nouvelle source, puis indiquez le fichier, l’URL ou l’emplacement GitHub.
La création, le remplacement et la publication d’une référence d’API nécessitent un abonnement actif ou en période d’essai.
Ce qui constitue une spécification valide
L’analyseur prend en charge OpenAPI, Swagger 2.0, GraphQL SDL et le fichier JSON d’introspection GraphQL.
Toute spécification de plus de 15 Mo est rejetée.
Étape suivante
Lorsque la nouvelle source est une URL ou GitHub, actualisez-la régulièrement dans Actualiser les sources des références d’API.