Seedr APIが公開されます

Sonarr、Radarr、Roku、Kodiの連携を動かしているのと同じAPIが、PremiumまたはV2ユーザーであれば誰でもリクエストに応じて利用できるようになりました。長いフォームも、個別の審査待ちもありません。サポートにメールをいただければ、私たちが有効化し、お客様は構築を開始できます。

これを構築した理由

Seedr APIはしばらくの間、静かにすべての機能を支えてきました。*arrスタックの連携も、新しいRokuやKodiアプリも、まだ発表していないいくつかの今後の連携も、すべてこのAPIと通信しています。どのケースでも同じ本番環境のパイプです。

当初、私たちはこれを厳しく制限していました。つまり、何を構築したいかを教えていただき、手動でアクセスを有効にしていました。APIがまだ新しく、どのエンドポイントに何がアクセスしているかを正確に知る必要があった頃は、それで理にかなっていました。しかし、安定してからは、その意味が薄れていきました。

変更を余儀なくされた問題点：

  • プラグイン開発者は、メールで待つのではなく、週末にプロトタイプを作成したかったのです。
  • ホームラボの愛好家は、午前2時にダッシュボードのアイデアを思いつき、月曜日までに勢いを失ってしまいました。
  • 連携パートナーは、文書化できる予測可能なストーリーを求めていました。

そこで、ユースケースによる制限をやめ、プランによる制限を開始しました。お客様にとっても、私たちにとっても、よりシンプルになりました。

変更点

以前：プロジェクトごとの承認。ユースケースを説明。担当者の対応を待つ。

現在：

  • PremiumまたはV2ユーザーですか？件名を「API access」としてサポートにメールしてください。お客様のアカウントで有効化します。
  • 当社のプラグインが使用するのと同じエンドポイント。サンドボックスも、個別のステージングもありません。最初のリクエストから本番環境にアクセスします。
  • 同じレート制限と動作当社の連携が動作するのと同じものです。Sonarrで動作するなら、お客様のツールでも動作します。
  • Premiumではないが、何か本格的なものを構築していますか？それでもメールしてください。私たちはそれらを読み、真のプロジェクトには例外を設けています。

APIが実際にできること

要するに、SeedrのウェブUIでできることはすべてAPIでもできます。これには以下が含まれます：

  • ダウンロードリンクとURLを追加アカウントに。
  • ファイルやフォルダのリスト表示、移動、名前変更、削除ファイルとフォルダ。
  • 直接ストリーミングURLを取得再生またはキャスト用。
  • アカウントの状態を読み取る（使用済みストレージ、アクティブな転送、完了履歴）。
  • フォルダを管理構造化されたオブジェクトとして（パスだけでなく）。

これは当社のSonarrおよびRadarrコネクタが使用するのと同じAPIです。これらのツールが動作するのを見たことがあるなら、APIが何ができるかを見たことになります。

今すぐ利用する方法

3つのステップ。

  1. プランを確認してください。有料プラン（Basic、Pro、Master、またはGold）をご利用いただくか、V2 Alphaに参加している必要があります。無料アカウントはデフォルトでは対象外です。必要に応じて/pricingでアップグレードしてください。
  2. サポートにメールしてください。Seedrアカウントに登録されているメールアドレスから、support@seedr.ccに、件名を正確にAPI accessとしてメッセージを送信してください。何を作成しているかについての短い説明は役立ちますが、Premiumユーザーには必須ではありません。
  3. お客様のアカウントで有効化します。ドキュメントと認証情報へのポインタを含む確認メールが届きます。通常、対応には1営業日かかります。

その後：

  • エンドポイントのドキュメントを読んでください。
  • ご自身のアカウントに対して最初のリクエストを作成してください。
  • 構築を開始してください。

公開プラグインや共有連携のプロトタイプを作成している場合は、メールでお知らせください。お客様のアカウントのエッジケースに注意し、APIに破壊的な変更があった場合はご連絡いたします。

ロードマップ

次に予定されていること：

  • アカウントUIでのセルフサービスキーこれにより、メールでご連絡いただく必要がなくなります。
  • キーごとのスコープこれにより、あるツールには読み取り専用キーを、別のツールにはフルアクセスキーを発行できます。
  • Webhookサポート「保存完了」や「ストレージ90%使用」などのイベントに対応。
  • 公開OpenAPI仕様自動生成されたクライアントライブラリ用。

正直なところ、APIは本番環境専用です。まだ公開サンドボックスはありません。実際のアカウントに触れずにテストする必要がある場合は、開発用に無料アカウントを、本番用にメインアカウントを使用してください。

構築を開始しましょう

皆様がこれを使って何をされるのかを見るのが楽しみです。共有する価値のあるものを構築された場合は、ぜひお知らせください。私たちのコミュニティに広めるお手伝いをいたします。

2025年11月21日