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]

POST API简介