Запускайте дистрибуцию из собственного продукта

Engine — это API Aevora. Создавайте релизы, доставляйте их на площадки, получайте аналитику и ведите учёт роялти через REST из продукта, которым ваши клиенты уже пользуются. Документация открыта, для разработки доступна песочница.

Интерфейс
REST и JSON
Аутентификация
Ключи API, свой набор для каждой среды
Песочница
Тестовые доставки без участия площадок

Четыре вызова проводят релиз от черновика до отчёта

API повторяет путь релиза в панели управления: создать, доставить, читать цифры по мере поступления, затем прочитать отчёт. Выберите вызов, чтобы увидеть, что вы отправляете и что получаете в ответ.

  • Запросы и ответы в формате JSON
  • Ошибка называет поле, в котором произошёл сбой, и причину
  • Одни и те же вызовы работают и в песочнице, и в продакшене

Engine API

Примеры запросов

POST/v1/releases

Тело запроса

{  "title": "Night Drive",  "artist": "Mira Kaya",  "label": "Northfield Audio",  "release_date": "2027-03-12"}

Ответ

{  "id": "rel_8f2k1",  "status": "draft",  "upc": null}

Что находится вокруг эндпойнтов

Вызовы — самая короткая часть интеграции. Остальное — то, что поддерживает её работу, когда за ней никто не следит.

Webhooks
Получайте событие, когда меняется статус доставки, релиз выходит или отчёт готов, и не опрашивайте API постоянно.
Ключи идемпотентности
Передайте ключ вместе с запросом на запись, и повторная попытка вернёт первый результат, а не создаст второй релиз.
Пагинация
Списки возвращают курсор. Передайте его обратно, чтобы получить следующую страницу, всегда в том же порядке.
Песочница
Отдельная среда со своими ключами. Доставки проходят весь путь и останавливаются перед площадками.
Версии
Версия входит в путь. Изменения, ломающие совместимость, выходят под новой версией, поэтому та, на которой вы строили, остаётся прежней.
Лимиты частоты запросов
Каждый ответ сообщает, сколько осталось от вашей квоты, а ограниченный запрос сообщает, когда повторить попытку.

От первого ключа до рабочей доставки

  1. 1

    Получите ключи

    Подайте заявку на аккаунт. После одобрения создайте ключ песочницы.

  2. 2

    Разрабатывайте в песочнице

    Создавайте релизы и запускайте тестовые доставки, пока интеграция не начнёт обрабатывать каждый статус.

  3. 3

    Запросите доступ к продакшену

    Расскажите, что вы создаёте. Мы проверим и выдадим ключи для продакшена.

  4. 4

    Доставляйте

    Переключитесь на ключ для продакшена, и те же вызовы дойдут до настоящих площадок.

Вопросы об Engine

Нет. Документация открыта для всех. Аккаунт, который мы открываем по заявке, нужен только тогда, когда вам понадобится ключ.

Да. Релиз, созданный через API, появляется в панели управления, а релиз, созданный в панели, можно прочитать и доставить через API.

Доставка проходит те же статусы, что и настоящая, и отправляет те же webhooks, но на площадки ничего не уходит.

Сделайте первый запрос в песочнице