X-Git-Url: https://git.ktnx.net/?a=blobdiff_plain;f=doc%2Fprotocol.md;h=d70f595f1e14301ad9723c3b1ca6ff0d7d16e1a0;hb=73020ec0d31c70350ef13067a60f8d2b0554d03a;hp=e0cf516c6658b533acb312c1ec5aa69153fc7e58;hpb=dfeabddaac016f698fa33d8568131baa761a4c0f;p=lsl.git diff --git a/doc/protocol.md b/doc/protocol.md index e0cf516..d70f595 100644 --- a/doc/protocol.md +++ b/doc/protocol.md @@ -15,7 +15,9 @@ GET /list Returns a JSON object with the following keys: - `lists`: a list of objects with the following keys: - - `uri`: tjhe list URIs. Referred to as `/list/$list_id` below. + - `uri`: the list URI. Referred to as `/list/$list_id` below. The part after + the last `/` (`$list_id`) is an integer that is unique among all shopping + lists - `name`: list name as entered by users - `lists_version`: a number that is incremented by 1 each time the list of shopping lists changes. Changes include adding, removing and renaming a @@ -27,7 +29,9 @@ GET /list/$list_id Returns a JSON object with the following keys: - `items`: a list of shopping list item objects with keys: - - `uri`: the URI of the individual list item + - `uri`: the URI of the individual list item (refered to as + `/list/$list_id/$item_id` below. The part after the last `/` (`$list_id`) + is a positive integer that is unique amont the items in the shopping list. - `description`: item description - `done`: a boolean flag marking the item as done - `version`: a number that is incremented by 1 each time the list items