偏好设置
2 endpoints.
读取调用者自己的偏好设置
Section titled “读取调用者自己的偏好设置”GEThttp://localhost:3000/api/preferences
调用者自己的书库视图偏好;任何从未设置过的值都会回落到默认值。未认证的调用者拿到的是默认值——不是别人的设置。
响应
200生效中的偏好设置。
{
"library_sortby": "",
"library_sortdir": ""
}请求失败 — 常见原因:实例地址填错或不可达;实例未开启「为客户端 API 启用 CORS」;或者文档站是 HTTPS 而实例是局域网内的纯 HTTP(浏览器按混合内容拦截)。可以用上面的「复制为 cURL」在终端里发同样的请求。
填写你自己的实例地址,请求由浏览器直接发往该地址。
更新调用者自己的偏好设置
Section titled “更新调用者自己的偏好设置”PUThttp://localhost:3000/api/preferences
保存调用者的书库视图偏好。请求中省略的字段保持原样。需要已认证的调用者;未认证的调用会被拒绝,而不是悄悄写进一个共享的存储桶。
请求体
application/json
响应
200已保存;响应体会回显保存后的值。
{
"library_sortby": "",
"library_sortdir": ""
}403没有已认证的调用者,无法确定偏好的归属。
{
"error": "",
"operation": "",
"success": 0,
"successMessage": ""
}该端点需要管理员令牌:访客(只读)令牌会被服务端拒绝。
请求失败 — 常见原因:实例地址填错或不可达;实例未开启「为客户端 API 启用 CORS」;或者文档站是 HTTPS 而实例是局域网内的纯 HTTP(浏览器按混合内容拦截)。可以用上面的「复制为 cURL」在终端里发同样的请求。
填写你自己的实例地址,请求由浏览器直接发往该地址。