APIアーキテクチャについて学ぶ：APIの基礎

REpresentation State Transfer（REST）は、統一インターフェイスを記述するための軽量アーキテクチャ モデルを提供します。通常は、基本的な転送プロトコルとしてHTTPを使用して適用されます。

RESTは、最も広く導入されているAPIベースのアーキテクチャ実装です。

Postman、『2022年版API現状レポート』

• RESTにはごく基本的なルールがいくつかあり、導入のハードルが低く、ドメイン モデルが強力であるため、比較的簡単に実装できます。
• 階層型のシステムなので、RESTインターフェイスの背後にあるシステムの複雑さが抽象化されます。例えば、コンシューマーが、Webサービスの背後にあるデータベース システムとのやり取りを意識することはありません。
  
• RESTは、JSON、YAMLなど、複数のコンテンツ タイプを柔軟にサポートします。

• OpenAPI仕様で十分に、APIの形式と構造をコンシューマーと共有できる場合。
• プロデューサーからコンシューマーへの要求がデフォルトでステートレスであるため、キャッシングをHTTPヘッダーに基づいて動的に決定する必要がある場合。
• プロデューサーが提供する単一のAPIのリソース モデルを拡張する場合、またはAPIゲートウェイを使用して同じベースURLで複数のAPIを提供する場合。

• 複数のソースにまたがってクエリを実行するためのクエリ言語を提供します。
• クライアントは、複数のAPIにまたがったフィールドを含め、必要なフィールドを正確に要求できるため、初期読み込み時間を短縮できます。
• スキーマ言語は、個々のAPIの型とAPIの結合方法を指定し、すべてのAPIにわたって単一のバージョンを提供できるため、バージョン管理が簡素化されます。

• 複雑さを抽象化するために既存のレガシー システムに補完的なテクノロジとして配置する場合。
• APIコンシューマーが、相互接続された幅広いサービスにわたって均一なアクセス、フィルタリング、クエリ実行を必要とする場合。
• 画面サイズとネットワークの可用性に制約があるモバイル デバイスで使用する場合。

• HTTP/2、軽量のプロトコル バッファ、シリアル化されたペイロード、ステートフル実装を使用することで、高いパフォーマンスと信頼性を実現します。
• ロード バランシング、トレース、健全性チェック、認証についてプラグ可能なサポートを提供します。
  
• すべての言語に対応した豊富なツールにより、高度なインターフェイス機能とメッセージの相互運用性を提供します。

• デバイス、モバイル アプリ、ブラウザをバックエンド マイクロサービスに接続する分散コンピューティングのラスト ワン マイルや、モバイルとデスクトップ/IoT間のインタラクションがあるクロスプラットフォーム アプリに使用する場合。
• 内部コンテナ トラフィック（「東西」）に使用する場合。
• ストリーミングを必要とする外部インターフェイス（「南北」）を使用する場合や、チャット、財務、ニュースなどのストリーミング アプリに使用する場合。