在 API Gateway 中测试基本请求验证

使用 API Gateway REST API 调用测试请求验证

1. 调用 GET /validation?q1=cat。

   GET /testStage/validation?q1=cat HTTP/1.1
   Host: abcdef123.execute-api.us-east-1.amazonaws.com
   Content-Type: application/json
   Accept: application/json
   

   因为 q1 所需的参数已设置并且非空，所以该请求通过验证。API Gateway 返回以下 200 OK 响应：

   [
       {
         "id": 1,
         "type": "cat",
         "price": 249.99
       },
       {
         "id": 2,
         "type": "cat",
         "price": 124.99
       },
       {
         "id": 3,
         "type": "cat",
         "price": 0.99
       }
   ]

2. 调用 GET /validation。

   GET /testStage/validation HTTP/1.1
   Host: abcdef123.execute-api.us-east-1.amazonaws.com
   Content-Type: application/json
   Accept: application/json
   

   因为 q1 所需的参数未设置，所以该请求没有通过验证。API Gateway 返回以下 400 Bad Request 响应：

   {
       "message": "Missing required request parameters: [q1]"
   }

3. 调用 GET /validation?q1=。

   GET /testStage/validation?q1= HTTP/1.1
   Host: abcdef123.execute-api.us-east-1.amazonaws.com
   Content-Type: application/json
   Accept: application/json

   因为 q1 所需的参数为空，所以该请求没有通过验证。API Gateway 返回与上一个示例相同的 400 Bad Request 响应。

4. 调用 POST /validation。

   POST /testStage/validation HTTP/1.1
   Host: abcdef123.execute-api.us-east-1.amazonaws.com
   Content-Type: application/json
   Accept: application/json
   h1: v1
   
   {
       "name" : "Marco",
       "type" : "dog",
       "price" : 260
   }

   因为 h1 所需的标头参数已设置（且非空），且负载格式符合 RequestDataModel 需要的属性和关联的约束，所以该请求通过验证。API Gateway 返回以下成功的响应。

   {
       "pet": {
         "name": "Marco",
         "type": "dog",
         "price": 260
       },
       "message": "success"
   }

5. 调用 POST /validation，但不指定 h1 标头或将其值为设置空。

   POST /testStage/validation HTTP/1.1
   Host: abcdef123.execute-api.us-east-1.amazonaws.com
   Content-Type: application/json
   Accept: application/json
   
   {
       "name" : "Marco",
       "type" : "dog",
       "price" : 260
   }

   因为 h1 所需的标头参数缺失或设置为空，所以该请求没有通过验证。API Gateway 返回以下 400 Bad Request 响应：

   {
       "message": "Missing required request parameters: [h1]"
   }

6. 调用 POST /validation，同时将负载的 type 属性设置为 bird。

   POST /testStage/validation HTTP/1.1
   Host: abcdef123.execute-api.us-east-1.amazonaws.com
   Content-Type: application/json
   Accept: application/json
   X-Amz-Date: 20170309T000215Z
   h1: v1
   
   {
       "name" : "Molly",
       "type" : "bird",
       "price" : 269
   }

   因为 type 属性值不是 ["dog", "cat", "fish"] 的枚举值，所以该请求没有通过验证。API Gateway 返回以下 400 Bad Request 响应：

   {
       "message": "Invalid request body"
   }

   将 price 设置为 501 违反了属性的约束条件。这会导致验证失败并返回相同的 400 Bad Request 响应。

在 API Gateway 控制台中使用 TestInvoke 在方法上测试请求验证

登录 API Gateway 控制台时，请执行以下操作：

1. 针对您已为其配置了请求验证程序映射的 API 选择 Resources (资源)。

2. 选择一种您已使用指定请求验证程序为其启用了请求验证的方法。

3. 在 Method Execution (方法执行) 下的客户端框中，选择 测试。

4. 针对所需请求参数或适用正文尝试不同的值，然后选择测试查看响应。