エンドポイント

📖 もうちょい詳しく

何が新しいの？

外部のサービスとプログラム同士でやり取りするとき、「どこに話しかければいいのか」を決める必要があります。エンドポイントは、その話しかける先を表すURL（ウェブ上の住所）です。多くのサービスはAPI（外部から機能を呼び出すための窓口）を用意していて、その窓口ひとつひとつにエンドポイントが割り当てられています。

どうやって動いてるの？

クライアント（呼び出す側のプログラム）が、エンドポイントのURLに向けてHTTPでリクエスト（お願いの通信）を送ります。すると、その住所を受け持つサーバが中身を処理して、結果を応答として返します。たとえば天気を知りたいなら天気用のエンドポイント、ユーザー情報なら別のエンドポイント、というように機能ごとに分かれているのが基本です。

何ができるの？

機能ごとに住所が分かれているおかげで、必要なものだけをピンポイントで呼び出せます。地図を表示したり、決済をしたり、メッセージを送ったりといった処理を、それぞれ対応するエンドポイントにお願いするだけで使えます。アプリ開発では、こうしたエンドポイントを組み合わせてサービスを形づくっていきます。

🌱 身近なたとえ

エンドポイントで例えると、お店の中にある「受付ごとの窓口」のようなものです。返品は返品カウンター、会計はレジ、問い合わせは案内所、というふうに用件ごとに行き先が決まっていますよね。エンドポイントも同じで、やりたいことごとに専用の窓口（URL）があり、そこへ用件を持っていくと担当が応じてくれます。

✅ まず覚えるポイント

• エンドポイントは、APIの接続先を表すURLです
• 機能ごとに別々のエンドポイントが割り当てられます
• クライアントがHTTPでリクエストを送る届け先になります
• サーバはその住所で受け取り、結果を応答として返します
• 必要な機能だけをピンポイントで呼び出せます

🧭 よくある勘違い

エンドポイントとAPIは同じもの？

近い言葉ですが、指す範囲が違います。APIは「外部から機能を使うための仕組み全体」を指し、エンドポイントはその中の「個々の接続先URL」を指します。ひとつのAPIに、複数のエンドポイントがぶら下がっていることが多いです。

エンドポイントは1つだけ？

そうとは限りません。多くのサービスでは、ユーザー一覧用・登録用・削除用といったように、用途ごとに複数のエンドポイントが用意されています。同じURLでも、送るリクエストの種類によって処理が変わる場合もあります。

🧩 関連して覚えると楽な言葉

• API: 外部から機能を呼び出す窓口の仕組み。エンドポイントはその個々の接続先
• REST: エンドポイントの並べ方を整理する、よく使われる設計の考え方
• HTTP: エンドポイントにリクエストを届けるときの通信のルール
• ペイロード（Payload）: リクエストに乗せて送る、中身のデータ

🏁 ひとことでまとめ

機能ごとに分かれた接続先のURLで、リクエストの行き先を決めてくれるのがエンドポイントです。