Actualiser les sources de référence de l’API
Les sources URL et GitHub peuvent s’actualiser automatiquement ou à la demande ; les références provenant d’un fichier importé ne peuvent pas être actualisées. Importez donc un nouveau fichier avec Replace spec à la place.
Actualiser manuellement
Accédez au Help Center dans le tableau de bord, puis cliquez sur la référence de l’API dans l’arborescence du contenu.
Sélectionnez Refresh now (affiché comme Refresh from source dans certaines vues) sur la référence.
Actualisation automatique
Les URL sources sont récupérées automatiquement toutes les six heures.
Les sources GitHub se synchronisent automatiquement lorsqu’un push modifie le fichier de spécification. Le dépôt, la référence (branche ou commit, définie par défaut sur la branche de production du dépôt) et le chemin du fichier relatif au dépôt doivent tous correspondre à la configuration de la référence.
Une source URL GraphQL doit autoriser l’introspection, sauf si l’URL renvoie directement du SDL GraphQL ; sinon, l’actualisation ne produit aucun schéma.
Exigences relatives aux URL
Les URL de spécification doivent utiliser HTTP ou HTTPS, ne doivent pas contenir d’identifiants intégrés et peuvent suivre au maximum cinq redirections.
Les URL pointant vers des hôtes privés ou de bouclage local, y compris via une redirection, sont bloquées.
Étape suivante
Lorsqu’une actualisation échoue, recherchez le message d’erreur correspondant dans Résoudre les erreurs des sources de référence de l’API.