API Seedr становится доступным

Тот же API, который используется для наших интеграций с Sonarr, Radarr, Roku и Kodi, теперь доступен по запросу любому пользователю Premium или V2. Никаких длинных форм, никаких очередей на индивидуальное рассмотрение. Напишите в поддержку, мы включим его, а вы создадите.

Почему мы это создали

API Seedr уже некоторое время незаметно обеспечивает работу всего. Интеграции стека *arr взаимодействуют с ним. Новые приложения Roku и Kodi взаимодействуют с ним. Несколько предстоящих интеграций, о которых мы еще не объявляли, также взаимодействуют с ним. Во всех случаях это один и тот же производственный канал.

Изначально мы строго ограничивали доступ: вы сообщали нам, что хотите создать, и мы вручную предоставляли доступ. Это имело смысл, когда API был новым, и нам нужно было точно знать, какой запрос поступает на какую конечную точку. После стабилизации это стало менее актуальным.

Проблема, которая вынудила нас измениться:

• Авторы плагинов хотели создать прототип за выходные, а не писать по электронной почте и ждать.
• Любители домашних лабораторий имели идею дашборда в 2 часа ночи и потеряли импульс к понедельнику.
• Партнеры по интеграции хотели предсказуемую историю, которую они могли бы документировать.

Поэтому мы перестали ограничивать доступ по сценарию использования и начали ограничивать по тарифному плану. Проще для вас. Проще для нас.

Что изменилось

Раньше: Одобрение для каждого проекта. Опишите свой сценарий использования. Ждите ответа человека.

Сейчас:

• Premium или V2? Напишите в поддержку с темой письма "API access". Мы включим его в вашей учетной записи.
• Те же конечные точки, которые используют наши плагины. Без песочницы, без отдельного промежуточного этапа. Вы обращаетесь к продакшену с первого запроса.
• Те же ограничения скорости и поведение с которыми работают наши собственные интеграции. Если это работает для Sonarr, это будет работать и для вашего инструмента.
• Не на Premium, но создаете что-то реальное? Все равно напишите. Мы читаем такие письма и делаем исключения для настоящих проектов.

Что на самом деле делает API

Краткая версия: все, что может делать веб-интерфейс Seedr, может делать и API. Это включает:

• Добавлять ссылки для скачивания и URL в вашу учетную запись.
• Перечислять, перемещать, переименовывать и удалять файлы и папки.
• Получать прямые потоковые URL для воспроизведения или трансляции.
• Читать состояние учетной записи (использованное хранилище, активные передачи, завершенная история).
• Управлять папками как структурированными объектами (а не просто путями).

Это тот же API, который используют наши коннекторы Sonarr и Radarr, поэтому, если вы видели, как работают эти инструменты, вы видели, что может делать API.

Как использовать это сегодня

Три шага.

1. Подтвердите свой тарифный план. Вам необходимо быть на платном тарифном плане (Basic, Pro, Master или Gold) или в V2 alpha. Бесплатные аккаунты по умолчанию не подходят. Обновите тариф на /pricing при необходимости.
2. Напишите в поддержку. С электронной почты вашей учетной записи Seedr, отправьте сообщение на _{support@seedr.cc} с темой письма точно: _{API access}. Короткое предложение о том, что вы создаете, поможет, но не является обязательным для пользователей Premium.
3. Мы включим его в вашей учетной записи. Вы получите подтверждение по электронной почте со ссылкой на документацию и вашими учетными данными. Срок выполнения обычно составляет 1 рабочий день.

После этого:

• Прочитайте документацию по конечным точкам.
• Напишите свой первый запрос к вашей собственной учетной записи.
• Создавайте.

Если вы создаете прототип публичного плагина или общей интеграции, сообщите нам об этом в письме. Мы будем следить за особыми случаями в вашей учетной записи и сообщим вам, если что-либо в API изменится критическим образом.

План развития

Что будет дальше:

• Ключи самообслуживания в пользовательском интерфейсе учетной записи чтобы вам вообще не нужно было писать нам по электронной почте.
• Области действия для каждого ключа чтобы вы могли выдать ключ только для чтения одному инструменту и ключ с полным доступом другому.
• Поддержка вебхуков для таких событий, как "сохранение завершено" или "хранилище заполнено на 90%".
• Публичная спецификация OpenAPI для автоматически генерируемых клиентских библиотек.

Честное ограничение: API предназначен только для продакшена. Пока нет публичной песочницы. Если вам нужно протестировать, не затрагивая вашу реальную учетную запись, используйте бесплатную учетную запись для разработки и основную учетную запись для продакшена.

Создавайте

Нам нравится видеть, что люди делают с этим. Если вы создадите что-то, чем стоит поделиться, дайте нам знать, и мы поможем вам достичь нашего сообщества.