🐿️WebAPIについてざっくり

WebAPIについてざっくり，LLMと対話しながらまとめました．間違っている箇所があったら，コメントで教えてください．

🧩 要するに何？

サーバーに「リクエスト（お願い）」を送ると、
サーバーが「レスポンス（返事）」としてデータを返してくれる。

この**やりとりのルールを決めた仕組みがWeb APIです。

つまり、HTTP という通信の仕組みを使って、
ネットワーク越しにクライアント（お願いする側）とサーバー（処理する側）がやりとりするための窓口（インターフェース） のことです。

サーバーの中でどんなプログラムが動いているのかは知らなくても、
クライアントはURI（アドレス）を指定して呼び出すだけでOK。

これによって、異なるアプリやサービス同士でも情報を共有したり、連携したりできるようになります。

📸 例：画像を白黒にするWebAPI

クライアント「ねこの画像を白黒にしたいなぁ。画像を白黒にするWebAPIを使おう！」
クライアント「サーバーさん、この画像を白黒にしてくれない？」（リクエスト）
サーバー「いいよ、変換するね」（内部で処理）
サーバー「はい、できたよ」（レスポンス）
クライアント「ありがとう、ちゃんと白黒になってる！」

このとき、クライアントはサーバーがどんな方法で白黒にしているか知らなくてもOKです。
WebAPIを通して「お願い」と「結果」をやりとりしているだけなのです。

このときの 「クライアントが送る場所（URL）」と「送る内容の形式」そして「返ってくるデータの形式」 を決めているものが WebAPI です。

WebAPIを作るとは？

WebAPIを作るときは、白黒の変換処理そのもの＋その処理を呼び出せる「入口（エンドポイント）」の両方を実装します。

① 白黒変換処理を作る

これは普通のプログラム処理です。

たとえばPythonなら：

from PIL import Image
def convert_to_grayscale(image_path):     
    image = Image.open(image_path)
    gray_image = image.convert("L")  # "L"は白黒モード     
    gray_image.save("gray.png")     return "gray.png"

これは画像を白黒に変換する関数です。
この部分だけでは「WebAPI」ではなく、ただのプログラム（関数）です。

② WebAPIとして公開する(WebAPIを作る)

次に、クライアントから「HTTPリクエスト」でこの処理を呼び出せるようにします。

Pythonなら Flask というライブラリでこう書けます：

from flask import Flask, request, send_file
from PIL import Image
import io

app = Flask(__name__)

@app.route("/api/convert-to-grayscale", methods=["POST"])
def convert_image():
    file = request.files["image"]         # クライアントから送られた画像
    image = Image.open(file.stream)
    gray_image = image.convert("L")

    # 変換後の画像をレスポンスとして返す
    img_io = io.BytesIO()
    gray_image.save(img_io, "PNG")
    img_io.seek(0)
    return send_file(img_io, mimetype="image/png")

if __name__ == "__main__":
    app.run()

ここで、

• /api/convert-to-grayscale が WebAPIのエンドポイント（入り口）
• convert_image() の中でやっているのが サーバーの処理部分
  です。

🔁 呼び出しの流れ

1. クライアントが POST /api/convert-to-grayscale に画像を送る
2. Flaskがそのリクエストを受け取る
3. convert_image() 関数が呼ばれて画像を白黒にする
4. 白黒画像をレスポンスとして返す

ただプログラムを書くことじゃない。
そのプログラムを“インターネット越しに呼び出せるようにする仕組み”を作ることなのだ．

実際に呼び出すには？

✅ 方法①：curlコマンドで呼び出す（簡単に試す方法）

パソコンのターミナル（コマンドプロンプト）でこう打ちます👇

curl -X POST -F "image=@cat.png" http://localhost:5000/api/convert-to-grayscale --output gray.png

🔍 意味：

• -X POST → 「POSTリクエストを送る」
• -F "image=@cat.png" → 「cat.pngという画像ファイルを送る」
• http://localhost:5000/api/convert-to-grayscale → サーバーのWebAPIの入口
• --output gray.png → 返ってきた結果（白黒画像）をgray.pngという名前で保存する

💬 つまり：

「この画像送るから白黒にして！」とサーバーにお願いして、
結果を受け取って保存している、ということです。

✅ 方法②：Pythonで呼び出す（プログラムから使う場合）

Python側から呼び出すなら、requests というライブラリを使います。

import requests

url = "http://localhost:5000/api/convert-to-grayscale"
files = {"image": open("cat.png", "rb")}
response = requests.post(url, files=files)
with open("gray.png", "wb") as f:
    f.write(response.content)

✅ 方法③：WebブラウザやJavaScriptから呼び出す

もしWebアプリ（フロントエンド）で呼び出したいなら、JavaScriptでこう書けます：

const formData = new FormData();
formData.append("image", fileInput.files[0]); 
fetch("http://localhost:5000/api/convert-to-grayscale", {
  method: "POST",
  body: formData
})
  .then(response => response.blob())
  .then(blob => {
    const url = URL.createObjectURL(blob);
    document.querySelector("#result").src = url; // 結果を表示
  });

これで、ボタンを押したら画像を送信して、
サーバーから返ってきた白黒画像をブラウザで表示できます。

まとめ

WebAPIは「決まったURI（住所） に対して、HTTPリクエストを送るだけで使える仕組み」。