Confirmed users
358
edits
Identity/AttachedServices/StorageProtocolZero: Difference between revisions
Identity/AttachedServices/StorageProtocolZero (view source)
Revision as of 04:25, 27 February 2013
, 27 February 2013no edit summary
No edit summary |
No edit summary |
||
| Line 51: | Line 51: | ||
All data transfer between server and client is utf8-encoded JSON bodies, with content-type of application/json. | All data transfer between server and client is utf8-encoded JSON bodies, with content-type of application/json. | ||
=== GET | === GET <server-url>/<userid>/info/collections === | ||
Returns a mapping of collection names associated with the account to the last-modified version number for each collection. | Returns a mapping of collection names associated with the account to the last-modified version number for each collection. | ||
| Line 68: | Line 68: | ||
* 304 Not Modified: the current version number is less than or equal to the value specified in the X-If-Modified-Since-Version header. | * 304 Not Modified: the current version number is less than or equal to the value specified in the X-If-Modified-Since-Version header. | ||
=== GET | === GET <server-url>/<userid>/storage/<collection> === | ||
Returns a list of all BSOs in the collection, or all those matching the specified query parameters. | Returns a list of all BSOs in the collection, or all those matching the specified query parameters. | ||
| Line 92: | Line 92: | ||
* 404 Not Found: the user has no such collection. | * 404 Not Found: the user has no such collection. | ||
=== POST | === POST <server-url>/<userid>/storage/<collection> === | ||
Creates or updates BSOs within a collection, and responds with the new version number for that collection. A maximum of 100 BSOs may be included in the request. | Creates or updates BSOs within a collection, and responds with the new version number for that collection. A maximum of 100 BSOs may be included in the request. | ||
| Line 107: | Line 107: | ||
* 400 Bad Request: something was wrong with the request, e.g. too many BSOs were included in the request. | * 400 Bad Request: something was wrong with the request, e.g. too many BSOs were included in the request. | ||
* 412 Precondition Failed: the last-modified version number of the collection is greater than the value in the X-If-Unmodified-Since-Version header. | * 412 Precondition Failed: the last-modified version number of the collection is greater than the value in the X-If-Unmodified-Since-Version header. | ||
=== DELETE <server-url>/<userid> === | |||
Deletes all data stored on behalf of the specified user. It is not possible to selectively delete data or to use X-If-Unmodified-Since-Version. | |||
Possible HTTP status codes: | |||
* 204 Not Content: the request completed successfully. | |||
== Request Headers == | == Request Headers == | ||