Configuration d'une personnalisation de réponse de passerelle dans OpenAPI - Amazon API Gateway

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration d'une personnalisation de réponse de passerelle dans OpenAPI

Vous pouvez utiliser l'extension x-amazon-apigateway-gateway-responses au niveau racine de l'API pour personnaliser des réponses de passerelle dans OpenAPI. La définition OpenAPI suivante montre un exemple pour la personnalisation de la réponse de passerelle GatewayResponse du type MISSING_AUTHENTICATION_TOKEN. 

  "x-amazon-apigateway-gateway-responses": {
    "MISSING_AUTHENTICATION_TOKEN": {
      "statusCode": 404,
      "responseParameters": {
        "gatewayresponse.header.x-request-path": "method.input.params.petId",
        "gatewayresponse.header.x-request-query": "method.input.params.q",
        "gatewayresponse.header.Access-Control-Allow-Origin": "'a.b.c'",
        "gatewayresponse.header.x-request-header": "method.input.params.Accept"
      },
      "responseTemplates": {
        "application/json": "{\n     \"message\": $context.error.messageString,\n     \"type\":  \"$context.error.responseType\",\n     \"stage\":  \"$context.stage\",\n     \"resourcePath\":  \"$context.resourcePath\",\n     \"stageVariables.a\":  \"$stageVariables.a\",\n     \"statusCode\": \"'404'\"\n}"
      }
    }

Dans cet exemple, la personnalisation remplace la valeur par défaut du code du statut (403) par 404. La personnalisation ajoute également à la réponse de passerelle quatre paramètres d'en-tête et un modèle de mappage de corps pour le type de média application/json.