Erros e avisos ao importar a API para o API Gateway

Ao importar o arquivo de definição externo para o API Gateway, ele pode gerar avisos e erros. As seções a seguir explicam os erros e os avisos que podem ocorrer durante a importação.

Erros durante a importação

Durante a importação, erros podem ser gerados para problemas importantes, como um documento inválido do OpenAPI. Os erros são retornados como exceções (por exemplo, BadRequestException) em uma resposta mal-sucedida. Quando ocorre um erro, a nova definição da API é descartada, e nenhuma alteração é feita na API existente.

Avisos durante a importação

Durante a importação, avisos podem ser gerados para problemas menores, como uma referência de modelo ausente. Se um aviso ocorrer, a operação continuará se a expressão de consulta failonwarnings=false for acrescentada à URL da solicitação. Caso contrário, as atualizações serão revertidas. Por padrão, failonwarnings é definido como false. Nesses casos, os avisos são retornados como um campo no recurso RestApi resultante. Caso contrário, os avisos serão retornados como uma mensagem na exceção.