3. Document Structure (文書構造)

JSON Patch 文書は, オブジェクトの配列を表す JSON [RFC4627] 文書です。各オブジェクトは, ターゲット JSON 文書 (Target JSON Document) に適用される単一の操作を表します。

以下は, HTTP PATCH リクエストで転送される JSON Patch 文書の例です:

PATCH /my/data HTTP/1.1
Host: example.org
Content-Length: 326
Content-Type: application/json-patch+json
If-Match: "abc123"

[
  { "op": "test", "path": "/a/b/c", "value": "foo" },
  { "op": "remove", "path": "/a/b/c" },
  { "op": "add", "path": "/a/b/c", "value": [ "foo", "bar" ] },
  { "op": "replace", "path": "/a/b/c", "value": 42 },
  { "op": "move", "from": "/a/b/c", "path": "/a/b/d" },
  { "op": "copy", "from": "/a/b/d", "path": "/a/b/e" }
]

JSON Patch 文書の評価は, ターゲット JSON 文書に対して開始されます。操作は, 配列内に現れる順序で順次適用されます。シーケンス内の各操作はターゲット文書に適用され; 結果として得られる文書が次の操作のターゲットになります。評価は, すべての操作が正常に適用されるか, エラー条件が発生するまで続行されます。

3. Document Structure (文書構造)​

3. Document Structure (文書構造)