URL にアクセスするとデータが返る「API」を作る

手順に迷ったときや、用語の意味を確かめたいときに開きましょう。

※ リンク切れの場合は、ページタイトルで検索してください。

ブラウザ（やアプリ）が API Gateway の URL にアクセスすると、API Gateway が裏の Lambda を呼び出します。Lambda はデータ（JSON）を作って返し、それがそのまま利用者へ返されます。

以下の要件を満たし、API の URL でデータが返ることを確認してください。

「関数を作る → データを返すコードを貼る → API Gateway をトリガーに追加 → URL で確認」の順に進みます。コードは貼り付けるだけ。意味は 1 行ずつ説明します。

1. リージョンを合わせ、Lambda 関数を作る

   リージョンが東京であることを確認し、Lambda コンソールで「関数の作成」→「一から作成」を選び、関数名 api-function、ランタイム Python（最新版）で作成します。

2. データ（JSON）を返すコードを貼り付ける

   「コードソース」の中身をすべて消して、次のコードを貼り付け、「Deploy」で保存します。

   ざっくり言うと：アクセスされたら、JSON 形式のデータ（あいさつのメッセージ）を返す API のプログラムです。（細かい意味は、コードの下で 1 行ずつ説明します）

   lambda_function.py（このまま貼り付け）

   import json
   
   def lambda_handler(event, context):
       data = { "message": "こんにちは！これは API が返したデータです。" }
       return {
           "statusCode": 200,
           "headers": { "Content-Type": "application/json" },
           "body": json.dumps(data, ensure_ascii=False)
       }

   • import jsonデータを「JSON という文字の形」に変換するための道具（機能）を読み込んでいます。
   • def lambda_handler(event, context):関数の「入口」です。API にアクセスがあると、AWS がここを実行します。
   • data = { "message": "..." }返したいデータを用意しています。{ } は項目をまとめた入れ物で、"message" という項目名に、あいさつの文章を入れています。
   • return { ... }利用者に返す「返事のセット」を返しています。
   • "statusCode": 200「成功しました」を表す番号です（200 ＝ OK）。
   • "headers": { "Content-Type": "application/json" }「この返事は JSON データです」と相手に伝えています。
   • "body": json.dumps(data, ensure_ascii=False)用意した data を、JSON の文字に変換して返しています。ensure_ascii=False は「日本語をそのまま読める形にする」おまじないです。
   字下げ（インデント）に注意

   関数の中身の行の先頭にある空白は、Python の大切なルールです。貼り付けた字下げを崩さないようにしましょう。

3. API Gateway をトリガーに追加する

   関数の画面で「トリガーを追加」を押し、ソースに API Gateway を選びます。「Create a new API（新しい API を作成）」を選び、API タイプは HTTP API、セキュリティは 「Open（オープン＝認証なし）」を選んで追加します。

   トリガーを追加 — API タイプの選択（イメージ）

   API タイプ

   HTTP API

   軽量で手早く作れる API

   REST API

   高機能だが設定項目が多い

   WebSocket API

   双方向の常時接続向け

   ↳今回は「データを返すだけ」なので、軽量な HTTP API を選びます

   HTTP API とオープンを選ぶ理由

   HTTP API は、軽くて手早く作れる種類の API です。「オープン」は学習用に「認証なしで誰でも呼べる」設定で、ブラウザですぐ試せます。本番では認証を付けたり、後片づけで消したりして、開けっ放しにしないことが大切です。

4. API の URL にアクセスして確認する

   トリガーが追加されると、API エンドポイントの URL（例：https://xxxx.execute-api.ap-northeast-1.amazonaws.com/default/api-function）が表示されます。これをブラウザで開くと、Lambda が返したデータ（例：{"message": "こんにちは！これは API が返したデータです。"}）が表示されるはずです。

   表示されるのは「画面」ではなく「データ」

   ページのように飾られた画面ではなく、データそのもの（JSON）が表示されます。これがアプリどうしのやり取りで使われる形です。「人が見る画面」とは目的が違う、という点を味わってみましょう。

初学者がよく引っかかる箇所を先回りでまとめました。答えそのものは載せていませんが、「どこを見直せばよいか」の手がかりとして使ってください。

要件の再確認ではなく、画面のどこを見れば達成を確認できるかをまとめました。Lambda・API Gateway のコンソールとブラウザを開いて、次を順に確かめましょう。

• Lambda 関数 api-function があり、コードが Deploy 済みになっている。
• 関数の画面に、API Gateway のトリガーが表示され、API エンドポイントの URL が分かる。
• その API のセキュリティがオープンになっている。
• ブラウザで API の URL を開くと、JSON データ（{"message": "..."}）が表示される。
• 日本語が文字化けせずに表示されている。

手を動かすことに加えて、次の問いに自分の言葉で答えられるようにしておくと、理解がより深まります。

1. 今回返ってきたのは、飾られたページではなく「データ（JSON）」でした。なぜアプリどうしのやり取りでは、画面ではなくデータをやり取りするのでしょうか。
   ヒント

   受け取る側（アプリ）は、見た目の飾りより「中身の値」がほしいからです。データだけ受け取れれば、それを使ってアプリが自由に画面を作れます。「見せる相手が人か、アプリか」で必要なものが違う、という観点で考えてみましょう。
2. 関数 URL でも Lambda を Web から呼べました。あえて API Gateway を前に置くと、どんなことがやりやすくなるでしょうか。
   ヒント

   複数の窓口（パス）を整理する、アクセスを制限・記録する、流量を制御する、といったことを「受付」でまとめて行えます。API が大きくなるほど、こうした受付の役割が効いてきます。「窓口が増えても整理できる」という観点で考えてみましょう。
3. 今回の API は、いつ呼んでも同じデータを返しました。実際のサービスでは、データはどこかに保存されていて、それを読み出して返すのが普通です。この API の裏に「データの保管場所」を足すなら、何を組み合わせるとよさそうでしょうか。
   ヒント

   Lambda の中から、データベースにデータを読みに行く・書きに行くようにすれば、保存された内容を返したり、受け取った内容を貯めたりできます。「API（受付）＋ Lambda（処理）＋ データベース（保管）」という組み合わせを思い浮かべてみましょう。

API は「認証なしで誰でも呼べる入口」です。学習が終わったら、開けっ放しにせず片づけましょう。

1. API を削除する：関数の「トリガー」から API Gateway のトリガーを削除します。あわせて、API Gateway コンソールで作成された API（HTTP API）が残っていれば、そちらも削除します。
2. Lambda 関数を削除する：「関数」一覧で api-function を選び、「アクション」→「削除」で消します。
3. ログを削除する（任意）：CloudWatch の「ロググループ」から、この関数のログを削除できます。