Preferences
2 endpoints.
Read the caller’s preferences
Section titled “Read the caller’s preferences”The caller’s own library-view preferences, falling back to the defaults for any value that has never been set. An unauthenticated caller gets the defaults — not another user’s settings.
Responses
200The effective preferences.
{
"library_sortby": "",
"library_sortdir": ""
}Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
Update the caller’s preferences
Section titled “Update the caller’s preferences”Stores the caller’s library-view preferences. Fields omitted from the request are left as they are. Requires an authenticated caller; an unauthenticated one is refused rather than silently writing to a shared bucket.
Request body
application/json
Responses
200Stored; the body echoes the resulting values.
{
"library_sortby": "",
"library_sortdir": ""
}403No authenticated caller to scope the preferences to.
{
"error": "",
"operation": "",
"success": 0,
"successMessage": ""
}This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.