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 ejemploPOST/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
Obtén tus claves
Solicita una cuenta. Cuando se apruebe, crea una clave de sandbox.
- 2
Desarrolla sobre el sandbox
Crea lanzamientos y ejecuta entregas de prueba hasta que tu integración gestione todos los estados.
- 3
Solicita acceso a producción
Cuéntanos qué estás construyendo. Lo revisamos y te emitimos las claves de producción.
- 4
Entregar
Cambia a la clave de producción y las mismas llamadas llegarán a tiendas reales.