REST APIとAmazon API Gatewayの基礎

REST APIとは？

REST APIは、Webサービス同士がやりとりするための仕組み（API）の一つです。AWSでは「Amazon API Gateway」を使ってREST APIを作ることができます。

REST APIのエンドポイントタイプ

REST APIには、3つのエンドポイントタイプがあります。

| タイプ | 説明 | |---|---| | エッジ最適化APIエンドポイント | 世界中のユーザーに近い場所（CloudFrontのエッジ）からAPIを提供します。 | | リージョンAPIエンドポイント | 指定したAWSリージョン内でAPIを提供します。同じリージョンのサービスと連携しやすいです。 | | プライベートAPIエンドポイント | インターネットからはアクセスできず、VPCエンドポイントからのみアクセスできます。 |

REST APIの主なユースケース

1. サーバーレスアプリのバックエンド
   モバイルアプリなどのバックエンドをLambdaやDynamoDBで構築し、API Gatewayで外部公開します。Cognitoで認証もできます。

2. VPC間・アカウント間のプライベートAPI連携
   パブリックなインターネットからのアクセスを許可せずに、VPCエンドポイントからのみのアクセスを許可することで、セキュアにアクセスする構成が可能です。

3. オンプレミスからAWSのAPIへアクセス
   社内システム（オンプレミス）からVPNやDirect Connect経由でAWSのAPIにアクセスできます。

4. API Gateway経由でコンテナアプリにアクセス
   バックエンドがECSなどのコンテナの場合、NLB（ネットワークロードバランサー）を使ってAPI Gatewayと連携します。

REST APIの構成要素

• リソース
  APIで扱うデータや機能の単位。例：/users、/users/{id}

• メソッド
  HTTPの操作方法。例：GET（取得）、POST（作成）、PUT（更新）、DELETE（削除）など。

• メソッドリクエスト
  APIに送るデータや認証情報。

• 統合リクエスト/レスポンス
  バックエンド（LambdaやECSなど）とのやりとりの設定。

• メソッドレスポンス
  API Gatewayが返すレスポンスの設定。

• モデル
  データの型や構造の定義。リクエストやレスポンスで利用する。

• ステージ
  APIの公開環境（例：dev、staging、prod）。

• オーソライザ
  認証・認可の仕組み（IAM、Cognito、Lambdaオーソライザなど）。