Learn VisualLearn API

RESTの3つの約束は、リソース指向・HTTPの意味の活用・ステートレス

リソース指向とは、URLが、操作ではなく、APIが公開する名詞を名付けることです。/getOrderではなく、/orders/42のように書きます。

HTTP自身の意味論の活用とは、HTTPの仕様が定めた意味を、そのままAPIの意味として使うことです。例えば、GETは安全な操作であること、404はリソースが見つからないことを表します。この意味は、仕様に従うどのREST APIでも同じです。そのため、クライアントは、そのAPI固有のドキュメントを読まなくても、メソッドやステータスコードの意味を理解できます。

ステートレスとは、各リクエストが、処理に必要なものをすべて自分で持ち、サーバーが前のリクエストの状態を覚えていることに頼らないことです。通常は、認証トークンがそれにあたります。これによって、サーバーが複数台あっても、どのサーバーでも、どのリクエストでも処理できます。

このコースのこれまでのレッスンは、すべて、この3つの約束のどれか1つを構成する部分でした。

この課の目標

RESTの3つの中核的な約束を挙げられる。リソース指向・HTTPの意味論の活用・ステートレスのそれぞれについて、違反例を見分けられる。

あるAPIは、エラーでも常に200を返し、実際の結果はJSON本文の中のstatusフィールドに入れている。どのREST上の約束に違反する?