Visión general de la API

La API pública de LabelGrid permite a los desarrolladores integrarse con LabelGrid de forma programática: leer su catálogo, crear y actualizar lanzamientos, subir recursos y enviar lanzamientos a distribución.

Qué ofrece la API

La API pública está montada bajo /api/public/... en api.labelgrid.com y proporciona acceso programático a:

Lanzamientos: listar, crear, actualizar, eliminar; subir portadas; validar; enviar a distribución
Pistas: listar, crear, actualizar; subir archivos de audio; gestionar licencias de pistas
Sellos: listar y gestionar sus perfiles de sello
Artistas: listar y gestionar perfiles de artista
Autores y colaboradores: listar y gestionar perfiles de autor/colaborador
Editores: listar y gestionar perfiles de editor
Webhooks: registrar endpoints de webhook para notificaciones asíncronas
Datos de referencia: géneros, idiomas, roles de colaboradores, instrumentos, territorios de distribución, outlets de distribución

Casos de uso habituales

Automatizar la creación de lanzamientos desde sus sistemas existentes
Sincronizar los datos del catálogo con su base de datos
Crear paneles e informes a medida
Integrar con sus herramientas de flujo de trabajo existentes
Impulsar servicios de distribución de marca blanca sobre LabelGrid

Cómo obtener acceso a la API

Para usar la API de LabelGrid, necesita:

Un plan de API activo y de pago: el acceso a la API y al sandbox requiere un plan de API de pago. La prueba gratuita de 7 días que viene con los planes estándar no incluye acceso a la API ni al sandbox, y los planes de API se facturan de inmediato (sin periodo de prueba).
Un token de API generado desde los ajustes de su cuenta: abra el menú del avatar en la esquina superior derecha y haga clic en Tokens de API (solo visible si el acceso a la API está habilitado)
(Opcional) Lista blanca de IP para mayor seguridad: configúrela en la misma área

Si no ve la opción Tokens de API en su cuenta, contacte con soporte para hablar de habilitar el acceso a la API en su plan.

Autenticación

Todas las solicitudes a la API deben incluir un Bearer token en la cabecera Authorization:

Authorization: Bearer YOUR_API_TOKEN

Documentación de la API

Para la referencia completa de endpoints, los esquemas de solicitud/respuesta y las herramientas en vivo de «pruébalo», consulte la documentación autogenerada:

Producción: https://api.labelgrid.com/docs/api
Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

La documentación incluye:

Una guía de autenticación
Todos los endpoints disponibles con ejemplos de solicitud y respuesta
Información sobre limitación de velocidad (rate limiting)
La configuración de webhooks

Sandbox

LabelGrid ofrece un entorno de sandbox para que pueda desarrollar y probar contra la API sin afectar a su catálogo de producción. El acceso al sandbox requiere un plan de API activo y lo aprovisionamos nosotros a petición: una vez activo su plan de API, contacte con soporte para configurarlo. Nosotros configuramos por usted la lista blanca de IP del sandbox; la lista blanca de IP de producción es de autoservicio en Tokens de API.

Webhooks

La API pública admite webhooks para la notificación asíncrona de eventos (cambios de estado de revisión, actualizaciones de entrega, etc.). Consulte Webhooks para la configuración y los tipos de evento disponibles.

Relacionado

¿Está desarrollando sobre la API de LabelGrid? Consulte el hub para desarrolladores para una visión general de lo que es posible. Si está impulsando un servicio de distribución de marca blanca sobre LabelGrid, la página infraestructura para distribuidores cubre el panorama general.

¿Necesita ayuda?

Si necesita asistencia con la API, contacte con nuestro equipo de soporte con los detalles técnicos de su integración.

¿Aún no usas LabelGrid?

Todo lo que acabas de leer está disponible en nuestra plataforma.

Descubre lo que LabelGrid puede hacer →