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 のやり取りを行うクロスプラットフォーム アプリを実現します。
• コンテナ間トラフィック（「東西」）用。
• ストリーミングを必要とする外部インターフェース（「North-South」）や、チャット、金融、ニュースなどのストリーミング アプリ向け。