Seedr API 正在开放

运行我们 Sonarr、Radarr、Roku 和 Kodi 集成的同一 API 现已可供任何 Premium 或 V2 用户按需使用。无需填写冗长表格，也无需逐案审查。发送电子邮件至支持团队，我们为您启用，您即可开始构建。

我们为何构建此功能

Seedr API 一直在默默地为所有功能提供支持。*arr 堆栈集成与它通信。新的 Roku 和 Kodi 应用也与它通信。一些我们尚未宣布的即将推出的集成也与它通信。在每种情况下，它都是相同的生产管道。

最初我们对其进行了严格限制：告诉我们您想构建什么，然后我们手动启用访问。当 API 尚处于早期阶段，我们需要确切知道哪个端点正在被访问时，这样做是合理的。一旦它稳定下来，这种做法的意义就减弱了。

促使我们做出改变的痛点：

• 插件开发者 希望在周末进行原型开发，而不是发送电子邮件并等待。
• 家庭实验室爱好者 在凌晨 2 点有了仪表板的想法，但到周一就失去了动力。
• 集成合作伙伴 希望有一个可预测的、可以记录的方案。

因此，我们不再按用例限制，而是开始按计划限制。对您来说更简单。对我们来说也更简单。

发生了什么变化

之前：按项目审批。描述您的用例。等待人工处理。

现在：

• Premium 或 V2 用户？ 发送电子邮件至支持团队，主题行精确填写“API access”。我们会在您的账户上启用它。
• 与我们插件使用的端点相同。 没有沙盒，没有单独的预发布环境。您的第一个请求就会直接访问生产环境。
• 相同的速率限制和行为 与我们自己的集成运行所针对的相同。如果它适用于 Sonarr，那么它也适用于您的工具。
• 不是 Premium 用户但正在构建真实项目？ 无论如何都请发送电子邮件。我们会阅读这些邮件，并为真正的项目提供例外。

API 的实际功能

简而言之：Seedr 网页 UI 能做的任何事情，API 都能做。这包括：

• 添加下载链接和 URL 到您的账户。
• 列出、移动、重命名和删除 文件和文件夹。
• 获取直接流媒体 URL 用于播放或投屏。
• 读取账户状态 （已用存储空间、活跃传输、完成历史记录）。
• 管理文件夹 作为结构化对象（而不仅仅是路径）。

它与我们的 Sonarr 和 Radarr 连接器使用的 API 相同，因此如果您见过这些工具工作，您就见过 API 能做什么。

如何立即使用它

三个步骤。

1. 确认您的套餐。 您需要订阅付费套餐（Basic、Pro、Master 或 Gold）或处于 V2 alpha 阶段。免费账户默认不符合条件。如果需要，请在 _/pricing 升级。
2. 发送电子邮件至支持团队。 从您的 Seedr 账户绑定的电子邮件地址，发送邮件至 _{support@seedr.cc} ，主题行精确填写：_{API access}。简要说明您正在构建什么会有帮助，但对于 Premium 用户来说不是必需的。
3. 我们会在您的账户上启用它。 您将收到一封确认电子邮件，其中包含文档链接和您的凭据。通常在 1 个工作日内完成。

之后：

• 阅读端点文档。
• 针对您自己的账户编写您的第一个请求。
• 开始构建。

如果您正在原型开发公共插件或共享集成，请在电子邮件中告知我们。我们会密切关注您账户上的边缘情况，并在 API 发生任何破坏性更改时通知您。

路线图

接下来会发生什么：

• 账户 UI 中的自助服务密钥 这样您就完全不需要给我们发送电子邮件了。
• 每个密钥的范围 这样您可以为某个工具颁发只读密钥，为另一个工具颁发完全访问密钥。
• Webhook 支持 用于“保存完成”或“存储空间已满 90%”等事件。
• 公共 OpenAPI 规范 用于自动生成的客户端库。

坦白说，限制是：API 仅用于生产环境。目前还没有公共沙盒。如果您需要在不触及真实账户的情况下进行测试，请使用免费账户进行开发，并使用您的主账户进行生产。

构建您的项目

我们乐于看到人们用它创造什么。如果您构建了值得分享的东西，请告诉我们，我们将帮助您触达我们的社区。