リソースの操作
RESTful APIはステートレスです。リソースマネージャーは、報告されるリソースの状態をリソースの説明として保持します。クライアントはアプリケーションの状態を保持します。クライアントはリソースをローカルで操作する可能性がありますが、PUT
またはPOST
が実行されるまで、リソースマネージャーが把握しているリソースは変更されません。
操作 |
HTTP動詞 |
説明 |
---|---|---|
作成 |
POST リソースのURI(ペイロード=リソースデータ) |
新しいリソースを作成します。同期 |
読み取り |
GET リソースのURI |
要求されたリソースの表現を返します。 |
更新 |
PUT リソースのURI(ペイロード=更新データ) |
既存のリソースを更新します。 |
PATCH リソースのURI(ペイロード=更新データ) |
リソースの一部を更新します。たとえば、リソースの1つのフィールドのみを更新する必要がある場合です。 |
|
削除 |
DELETE リソースのURI |
指定されたリソースを削除します。 |