API の種類

API Gateway には、REST API、HTTP API、WebSocket API があります。REST API は、使用量プランと API キー、キャッシュ、リクエストの検証、変換のテンプレートなど機能が多いのが特徴です。HTTP API は機能を絞った軽い API です。双方向の通信が必要なチャットなどは WebSocket API を使います。

Lambda プロキシ統合の返し方

プロキシ統合では、リクエストの中身がほぼそのまま Lambda に渡り、Lambda の返り値がそのまま応答になります。返り値は statusCode、headers、body（文字列）の形にします。形が違うと、API Gateway は 502 Bad Gateway を返します。

ステージとステージ変数

デプロイした API は、dev や prod のようなステージに載せます。ステージごとに URL が分かれ、ステージ変数で呼び先の Lambda のエイリアスなどを切り替えられます。

スロットリングとタイムアウト

• スロットリング … アカウント全体の既定は1秒あたり 10,000 リクエスト。超えると 429 Too Many Requests。使用量プランで API キーごとの上限や割り当てを決められる
• タイムアウト … REST API の統合タイムアウトは 50 ミリ秒〜29 秒。超えると 504 Gateway Timeout。リージョンとプライベートの API は 29 秒より長くする申請ができる
• キャッシュ … REST API のステージで有効にでき、TTL は既定 300 秒、最大 3,600 秒

エラーの番号から、どこで止まったかを読み分けることが、試験でも実務でも役に立ちます。

• REST API・HTTP API・WebSocket API の違い
• Lambda プロキシ統合の返り値の形と 502 エラー
• ステージとステージ変数による環境の切り替え
• スロットリング（429）・タイムアウト（504）・キャッシュ