Запускайте дистрибуцию из собственного продукта
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
Получите ключи
Подайте заявку на аккаунт. После одобрения создайте ключ песочницы.
- 2
Разрабатывайте в песочнице
Создавайте релизы и запускайте тестовые доставки, пока интеграция не начнёт обрабатывать каждый статус.
- 3
Запросите доступ к продакшену
Расскажите, что вы создаёте. Мы проверим и выдадим ключи для продакшена.
- 4
Доставляйте
Переключитесь на ключ для продакшена, и те же вызовы дойдут до настоящих площадок.