Gestiona la distribución desde tu propio producto

Engine es la API de Aevora. Crea lanzamientos, entrégalos a las tiendas, consulta analíticas y gestiona regalías mediante REST, desde el producto que tus clientes ya usan. La documentación es pública y hay un sandbox para desarrollar.

Interfaz
REST y JSON
Autenticación
Claves de API, un juego por entorno
Sandbox
Entregas de prueba, sin tiendas de por medio

Cuatro llamadas llevan un lanzamiento del borrador a la liquidación

La API sigue el camino que recorre un lanzamiento en el panel: se crea, se entrega, se leen las cifras a medida que llegan y después se lee la liquidación. Elige una llamada para ver qué envías y qué recibes.

  • Las solicitudes y las respuestas son JSON
  • Un error indica el campo que falló y por qué
  • Las mismas llamadas funcionan en el sandbox y en producción

API de Engine

Solicitudes de ejemplo

POST/v1/releases

Cuerpo de la solicitud

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

Respuesta

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

Lo que rodea a los endpoints

Las llamadas son la parte corta de una integración. Estas son las piezas que la mantienen funcionando cuando nadie la vigila.

Webhooks
Recibe un evento cuando una entrega cambia de estado, un lanzamiento se publica o una liquidación está lista, para no tener que consultar continuamente.
Claves de idempotencia
Envía una clave con una solicitud de escritura y un reintento devolverá el primer resultado en lugar de crear un segundo lanzamiento.
Paginación
Las listas devuelven un cursor. Envíalo de vuelta para obtener la página siguiente, siempre en el mismo orden.
Sandbox
Un entorno separado con sus propias claves. Las entregas se ejecutan de principio a fin y se detienen antes de llegar a cualquier tienda.
Versionado
La versión forma parte de la ruta. Un cambio incompatible sale con una versión nueva, de modo que la que usaste para desarrollar se mantiene tal cual.
Límites de frecuencia
Cada respuesta indica cuánto te queda de tu cuota, y una solicitud limitada te dice cuándo volver a intentarlo.

De la primera clave a la entrega en producción

  1. 1

    Obtén tus claves

    Solicita una cuenta. Cuando se apruebe, crea una clave de sandbox.

  2. 2

    Desarrolla sobre el sandbox

    Crea lanzamientos y ejecuta entregas de prueba hasta que tu integración gestione todos los estados.

  3. 3

    Solicita acceso a producción

    Cuéntanos qué estás construyendo. Lo revisamos y te emitimos las claves de producción.

  4. 4

    Entregar

    Cambia a la clave de producción y las mismas llamadas llegarán a tiendas reales.

Preguntas sobre Engine

No. La referencia es pública. Solo necesitas una cuenta, que abrimos por solicitud, cuando quieras una clave.

Sí. Un lanzamiento creado mediante la API aparece en el panel, y uno creado en el panel se puede leer y entregar mediante la API.

La entrega pasa por los mismos estados que una real y envía los mismos webhooks, pero no se envía nada a ninguna tienda.

Haz tu primera solicitud en el sandbox