Erreurs et avertissements liés à l’importation de votre API dans API Gateway

Lorsque vous importez votre fichier de définition externe dans API Gateway, des avertissements et des erreurs peuvent être générés. Les sections suivantes décrivent les erreurs et les avertissements susceptibles de se produire lors de l’importation.

Erreurs lors de l’importation

Lors de l’importation, des erreurs peuvent être générées pour les principaux problèmes, comme un document OpenAPI non valide. Les erreurs sont renvoyées en tant qu’exceptions (par exemple, BadRequestException) dans une réponse infructueuse. Lorsqu’une erreur se produit, la nouvelle définition d’API est ignorée et aucune modification n’est apportée à l’API existante.

Avertissements lors de l’importation

Lors de l’importation, des avertissements peuvent être générés pour les problèmes mineurs, tels que l’absence d’une référence de modèle. En cas d’avertissement, l’opération continue si l’expression de requête failonwarnings=false est ajoutée à l’URL de la demande. Sinon, les mises à jour sont annulées. Par défaut, la propriété failonwarnings a la valeur false. Dans ce cas, les avertissements sont renvoyés sous la forme d’un champ dans la ressource RestApi obtenue. Sinon, les avertissements sont renvoyés sous la forme d’un message dans l’exception.