豆瓣用户数据服务

这是一个获取豆瓣用户已看电影、电视剧和已读书籍数据的服务。

所有获取的数据都经过过滤，只保留以下信息：名字、标记时间、用户评论、用户评分和图片链接。

API 接口

GET /api/users

获取所有已保存的用户列表

GET /api/users/:uid

获取指定用户的所有数据

可选参数: ?refresh=true 强制获取最新数据

GET /api/users/:uid/stats

获取用户统计数据

GET /api/users/:uid/movies

获取用户看过的电影

可选参数: ?status=done|doing|mark 按状态过滤，?refresh=true 强制刷新

GET /api/users/:uid/tvshows

获取用户看过的电视剧

可选参数: ?status=done|doing|mark 按状态过滤，?refresh=true 强制刷新

GET /api/users/:uid/books

获取用户读过的书籍

可选参数: ?status=done|doing|mark 按状态过滤，?refresh=true 强制刷新

GET /api/items/:type/:id

获取特定内容的详情 (只包含名字、评分和图片)

类型(type): movie, book, music

POST /api/fetch/:uid

强制从豆瓣API获取最新数据

GET /api/fetch/:uid

使用GET方法强制从豆瓣API获取最新数据（便于浏览器直接访问）

GET /api/cache/stats

获取图片缓存统计信息

POST /api/cache/clean

清理过期的缓存图片（默认保留30天）

使用示例

获取用户 "ahbei" 的所有看过的电影:

GET http://localhost:3001/api/users/ahbei/movies

获取用户 "ahbei" 正在观看的电影:

GET http://localhost:3001/api/users/ahbei/movies?status=doing

获取用户 "ahbei" 想看的电影:

GET http://localhost:3001/api/users/ahbei/movies?status=mark

获取电影详情:

GET http://localhost:3001/api/items/movie/26683723

强制获取用户 "ahbei" 的最新数据:

GET http://localhost:3001/api/fetch/ahbei

或者在获取用户数据时附加refresh参数:

GET http://localhost:3001/api/users/ahbei?refresh=true

状态说明

done: 已观看（影视）/ 已阅读（书籍）

doing: 正在观看（影视）/ 正在阅读（书籍）

mark: 想看（影视）/ 想读（书籍）

图片缓存功能

本服务自动缓存豆瓣的图片封面到本地，提高访问速度并减少对豆瓣服务器的请求。

API返回的数据中包含以下字段：

originalImage: 豆瓣原始图片地址

image: 优先使用本地缓存地址，如果缓存失败则使用原始地址

cachedImage: 本地缓存地址（如果缓存成功）

缓存的图片通过 /cache/images/ 路径访问