更新 2026年5月26日

开放API上线:API Key 管理与完整接口文档

本次更新围绕「开放 API」做了一整套从生成密钥、接入文档、到接口安全的完整能力建设,让任何开发者都能基于低端影视的数据快速搭建自己的工具与应用。

一、API Key 自助管理

在个人资料页新增了 API Key 管理区。

每位用户可以自由生成、查看、复制、重新生成、吊销自己的密钥。生成的密钥以 ddys_ 前缀开头,长度 61 位,唯一对应当前账号。

重新生成会立即让旧 Key 失效,吊销会彻底回收密钥并允许后续重新申请。所有操作均带 CSRF 保护和确认弹窗。

二、完整 API 文档

新建 /api-docs 文档页,详细列出全部 25 个接口。

包括分类、地区、影片列表/详情/资源/相关/评论、搜索、建议、热门、最新、日历、片单、分享、求片、活动流、用户主页等公开接口。

以及发评论、删评论、关注、举报失效资源、查询自己资料等需要认证的接口。

文档包含每个接口的请求方法、路径、参数说明、响应格式、HTTP 状态码、错误码说明,以及调用示例。

三、调用方式

公开接口直接 GET 调用即可,无需任何认证。

需要认证的接口在请求头加上 Authorization: Bearer <你的Key> 即可。

所有响应统一为 JSON 格式,成功时返回 success:true 加 data,失败时返回 success:false 加 message 与对应 HTTP 状态码。

列表接口统一支持 page、per_page 分页参数。

四、安全与限速

API 系统内置多重安全防护。边缘按 Authorization Header 做了 60 次/分钟的速率限制,每个 Key 独立计数。

服务端还做了 60 秒内同一用户对同一目标只能发 1 条评论的防刷;评论支持反垃圾词过滤,并记录用于后续审计。

所有写操作均需有效 Key,被封禁账号会被立即拒绝。

五、应用场景

借助开放 API,开发者可以快速实现:

第三方移动客户端、浏览器扩展(一键看更多源)、Telegram/Discord 推送 Bot、RSS 订阅器、个人聚合 Dashboard、AI Agent 工具调用、数据分析与可视化等。

六、相关链接

- 申请 API Key

- 接口文档

我们鼓励开发者基于这套 API 探索更多创意场景,请遵守合理使用边界,不要滥用或用于商业爬取。