POST API简介
POST API 是什么
POST API 定义了一组应用程序接口,使用它可以不用登陆本站,使用第三方网站或者APP向本站发布内容。
POST API 的适用范围
POST API 允许个人、组织、第三方站点、APP、宇宙生物、超能力者 等各类行为主体使用。
POST API 在哪里开启?
在使用POST API前需要开启API功能,并获取API KEY和用户ID,位于会员面板的“我的API”项目下。请先去那里开启~
POST API 如何使用
在获取API KEY后,请参照 这个简单的示例页面(一个纯HTML写的API客户端) 开始了解。
首先,POST API接收请求的地址是:
/addon.php?r=api/post/76cad81b
该地址接收一组通过"multipart/form-data"编码提交上来的结构化的POST数据,数据结构为:
{ sort_id: string "类别ID", title: string "资源名称", intro: string "资源介绍", discuss_url: string "主页地址", user_id: string "用户ID", api_key: string "API KEY", }
以上结构可以在示例页面上,测试选项中选择“数据结构”来重现
下面列出类别ID(sort_id)和类别名称的对应关系:
动画:sort_id=1 漫画:sort_id=2 音乐:sort_id=3 周边:sort_id=4 其它:sort_id=5 Raw :sort_id=6
如何调试POST API
向POST API提交数据后,API会返回成功或失败的信息,以及一些附加消息,基本响应结构为:
{ status: string "返回failed代表失败,success发布成功", code: integer "数字的错误代码", message: "对该返回内容的描述", }如收到success的status返回即发布成功了,其他均为失败,请以此判断。
关键应答消息一览表
{"status":"success","code":200,"info_hash":"这里会返回infohash"} - 发布成功,会同时返回种子的infohash,第三方可以通过该infohash生成存在的页面地址:/show-{infohash}.html即是页面地址 {"status":"failed","code":103,"message":"torrent already exists","info_hash":"这里会返回存在的infohash"} - 上传的种子已存在,会同时返回存在的种子的infohash,第三方可以通过该infohash生成存在的页面地址:/show-{infohash}.html即是页面地址 {"status":"failed","code":114,"message":"auth failed"} - 认证失败,代表提交的用户ID和APP KEY不正确 {"status":"failed","code":116,"message":"api quota exceeded, please try later"} - 发布数量超过系统限制
POST API安全限制
24小时内(24 * 3600秒)使用POST API成功发布的数量限制为15条,遇到已存在的发布页也计入数量(code:103 情况)
技术支持
联系邮箱:[email protected]