API de viewneo
Con la API de viewneo controlas tu cuenta desde tus propios sistemas: subir archivos multimedia, rellenar playlists, activar reproductores y obtener pruebas de reproducción. Usos habituales son las cartas desde el sistema de caja, los precios desde la gestión de inventario o las ocupaciones desde el sistema de reservas.
Requisitos
Sección titulada «Requisitos»- El complemento API está contratado (consulta Complemento API). Sin contratarlo, cada llamada responde con
403 SUBSCRIPTION_REQUIRED. - Un token de API o un cliente OAuth de Ajustes › Acceso a la API (consulta Autenticación).
URL base
Sección titulada «URL base»https://cloud.viewneo.com/api/public/v1Con White Label también accedes a la API en tu propia dirección; la URL base exacta figura en Ajustes › Acceso a la API.
La primera llamada
Sección titulada «La primera llamada»curl https://cloud.viewneo.com/api/public/v1/devices \ -H "Authorization: Bearer $API_TOKEN"Si recibes una lista de tus dispositivos, todo está configurado.
La referencia completa
Sección titulada «La referencia completa»Todos los endpoints con sus parámetros, respuestas y códigos de error están en la referencia interactiva, en /api/public/v1/docs; en viewneo, por tanto, en cloud.viewneo.com/api/public/v1/docs. La descripción en formato OpenAPI 3 está en /api/public/v1/openapi.json, para Postman, Insomnia, Bruno o un generador de código.
Versionado
Sección titulada «Versionado»La versión figura en la ruta (/v1). Dentro de v1 solo se añaden cambios compatibles con versiones anteriores: endpoints nuevos, parámetros opcionales nuevos, campos nuevos en las respuestas. Construye tu cliente de forma que ignore los campos desconocidos. Los cambios incompatibles reciben una versión nueva.
Siguientes pasos
Sección titulada «Siguientes pasos»- Autenticación: tokens, OAuth y permisos
- Endpoints: áreas, paginación, errores y límites
- Ejemplos: procesos habituales para reproducir