APIの紹介

Webサービスは、ソフトウェアアプリケーション同士がWeb上で通信するための手段。これにより、異なるプラットフォームやプログラミング言語で構築されたソフトウェアシステム間の通信が可能となる。例えば、C#で書かれたアプリが自分のコンピュータ上で動作し、Webサービスを利用してウェブサイトと通信できる。

Webサービスには複数の種類があり、幅広い分野だが、ここでは最も一般的なAPIに焦点を当てる。APIはこのレベルで学ぶのに適した内容。

API（Application Programming Interface）は、クライアントがサーバーと通信するためのインターフェース。

クライアントは通常、外部のアプリケーション。一般的にはクライアントをユーザーと定義するが、より具体的にはWebブラウザやコンソールアプリケーションなどのアプリケーション。また、クライアントは複数の部分やプログラミング言語で構築された大規模アプリケーションの一部である場合もある。

サーバーはアプリケーションをホストするコンピュータであり、ウェブサイトやデータベースシステム、その他のものが該当する。

実際には、クライアントはWebリクエストを通じてサーバーにメッセージを送り、サーバーはリクエストを処理してレスポンスを返す。Webリクエストの送信方法については次の章で学習する。

サーバーに送信するWebリクエストは、より具体的にはHTTPリクエスト。HTTPはクライアントとサーバー間のデータ通信プロトコル。HTTPリクエストは、クライアントからサーバーへHTTPプロトコルを使って送信されるメッセージ。HTTPプロトコルの仕組みを理解する必要はないが、どのような種類のHTTPリクエストがあるかは知っておく必要がある。最も一般的なHTTPリクエストの種類は次の4つ：

• GET: サーバーからデータを取得。情報の取得に使用し、サーバーに副作用を与えない；
• POST: 新しいリソースを作成するためにデータをサーバーに送信。データベースの更新やフォームデータの処理などに利用される；
• PUT: サーバー上のリソースを更新。新しいリソースの作成や既存リソースの完全な置換に使用される；
• DELETE: サーバー上のリソースの削除を要求。指定したリソースを削除するために使用される。

クライアントがサーバーにHTTPリクエストを送信する際、リクエスト内でHTTPメソッドも指定する。HTTPメソッドはリクエストの種類（GET、POST、PUT、DELETEなど）を示し、受信側のサーバーがリクエストを適切に処理するための情報となる。

多くの処理はAPI側で行われます。例えば、クライアントからのメッセージの解析やデコードなどが含まれます。