Añadir/actualizar el archivo de configuración RIP
Las configuraciones RIP están vinculadas a un ordenador específico, identificado por su ComputerGUID. Si cualquier archivo de configuración RIP con el ComputerGUID el archivo de configuración RIP se actualiza, de lo contrario se añade un nuevo archivo de configuración RIP.
URL:
POST http://api.aurelon.com/api/v2/
configuración
Cabeceras de solicitud:
Tipo de contenido : multipart/form-data
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Cuerpo de la solicitud:
Datos del formulario 1: obligatorio
-
- Nombre: JsonString
- Content-Type: application/json
- {«ComputerGUID»:»00000000-0000-0000-0000-000000000000″} El GUID del ordenador RIP se pasa como ComputerGUID
Datos del formulario 2: obligatorio
-
- Nombre: RIP.xml (el elemento del archivo de entrada puede tener cualquier nombre)
- Content-Type: application/xml
- El archivo XML de la configuración
Respuesta:
El tipo de contenido de la respuesta está en formato JSON
El éxito:
- 200 OK : «Configuración añadida con éxito»
Error:
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 415 Tipo de medio no soportado : {«Mensaje»: «Esta solicitud no tiene el formato adecuado»}
- 401 No autorizado : {«Mensaje»: «»HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 400 Malos pedidos : {«Mensaje»: «ComputerGUID» requerido»}
- 400 Bad Request : {«Mensaje»: «Validación de ComputerGUID fallida»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Ejemplo de archivo de configuración XML:
aquí
Obtenga la configuración
Descarga el archivo de configuración RIP con ComputerGUID si se encuentra.
URL:
GET http://api.aurelon.com/api/v2/
configuración/<ComputerGUID>
Cabeceras de solicitud:
MisKey : ver Autenticación
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Respuesta:
El tipo de contenido es application/xml y contiene el XML de la configuración del ordenador RIP. O el tipo de contenido application/json cuando con el contenido de error.
El éxito:
- 200 OK : Configuración XML
Error:
- 401 No autorizado : {«Mensaje»: «Invalid MisKey»}
- 401 No autorizado : {«Mensaje»: «La cabecera «HardwareHash» no es válida»}
- 404 No encontrado : {«Mensaje»: «ComputerGUID no encontrado»}
- 401 No autorizado : {«Mensaje»: «»MisKey» o «HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Obtener la lista de sitios
Recibe la lista de sitios activos identificados por su número de serie
URL:
GET http://api.aurelon.com/
api/v2/configuración/sitios
Cabeceras de solicitud:
MisKey : ver Autenticación
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Respuesta:
Tipo de contenido application/json y contiene el JSON de los sitios conocidos identificados por el número de serie.
El éxito:
- 200 OK : Conjunto de sitios
Ex:
[{
«SiteGUID»:»8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
«SerialNumber»:333674,
«Ubicación»:null,
}, {
…
}]
Error:
- 401 No autorizado : {«Mensaje»: «Invalid MisKey»}
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 401 No autorizado : {«Mensaje»: «»MisKey» o «HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Obtener la configuración del sitio
Recibe la lista de dispositivos/colas activos y RIPs del número de serie
URL:
GET http://api.aurelon.com/
api/v2/configuration/site/<SerialNumber>
Cabeceras de solicitud:
MisKey : ver Autenticación
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Respuesta:
Tipo de contenido application/json y contiene el JSON de las configuraciones conocidas en el sitio identificado por el número de serie.
El éxito:
- 200 OK : Conjunto de ordenadores, sus dispositivos y sus colas.
Ex:
[{
«ComputerGUID»:»8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
«Nombre»: «mirip.empresa.dominio»,
«Modified»:»2018-06-27T07:56:36Z»,
«Dispositivos»:[{
«DeviceGUID»:»6da06b44-20ee-11e6-b287-07f164aa386e»,
«Nombre»: «Durst Rhotex 322»,
«Modified»:»2018-06-27T07:56:36Z»,
«DriverID»:1601
}, {
…
}]
}, {
…
}]
Error:
- 401 No autorizado : {«Mensaje»: «Invalid MisKey»}
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 404 No encontrado : {«Mensaje»: «Número de serie no encontrado»}
- 401 No autorizado : {«Mensaje»: «»MisKey» o «HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Sincronización de la configuración
Actualizar la lista de dispositivos/colas activas en un RIP
URL:
POST http://api.aurelon.com/
api/v2/configuración/sincronización
Cabeceras de solicitud:
Tipo de contenido : application/json
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Cuerpo de la solicitud:
Objeto JSON que contiene:
- ComputerGUID – requerido – el GUID del ordenador
- DeviceList – requerido – Matriz de objetos por dispositivo. Cada objeto que contiene:
- DeviceGUID – requerido – GUIDs de dispositivos activos en RIP
- QueueList – Matriz de GUIDs de colas activas en RIP
Respuesta:
Tipo de contenido application/json que contiene el resultado de la operación.
El éxito:
- 200 OK : «Configuración guardada con éxito»
Error:
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 415 Tipo de medio no soportado : {«Mensaje»: «Esta solicitud no tiene el formato adecuado»}
- 401 No autorizado : {«Mensaje»: «»HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 400 Bad Request : {«Mensaje»: «ComputerGUID» requerido»}
- 400 Bad Request : {«Mensaje»: «El campo «DeviceList» es obligatorio»}
- 400 Bad Request : {«Mensaje»: «El campo «QueueList» es obligatorio»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Añadir/actualizar RIP
Si cualquier RIP con ComputerGUID se actualiza el RIP, de lo contrario se añade un nuevo RIP.
URL:
POST http://api.aurelon.com/
api/v2/configuración/rip
Cabeceras de solicitud:
Tipo de contenido : application/json
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Cuerpo de la solicitud:
Objeto JSON que contiene:
- ComputerGUID – requerido – el GUID del ordenador
- ComputerName – nombre del ordenador o nombre DNS
- OperatingSystem – Tipo y versión del sistema operativo
Respuesta:
Tipo de contenido application/json que contiene el resultado de la operación.
El éxito:
- 200 OK : «Datos del ordenador guardados con éxito»
Error:
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 415 Tipo de medio no soportado : {«Mensaje»: «Tipo esperado: application/json»}
- 401 No autorizado : {«Mensaje»: «»HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 400 Bad Request : {«Mensaje»: «ComputerGUID» requerido»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Añadir/actualizar dispositivo
Si cualquier dispositivo con DeviceGUID se encuentra el dispositivo se actualiza, de lo contrario se añade un nuevo dispositivo si es parte de la licencia. Si el DeviceGUID no forma parte de la licencia se devuelve un error.
URL:
POST http://api.aurelon.com/
api/v2/configuración/dispositivo
Cabeceras de solicitud:
Tipo de contenido : application/json
MisKey : ver Autenticación
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Cuerpo de la solicitud:
Objeto JSON que contiene:
- DeviceGUID – requerido – el GUID del dispositivo
- ComputerGUID – necesario – el RIP en el que está instalado este dispositivo
- Nombre
- Tipo
- MediaType
- MediaSize
- MediaSource
- Fabricante
- Modelo
- DriverID (ID de conductor único de la base de datos HUB)
- ConnectionURI
Respuesta:
Tipo de contenido application/json que contiene el resultado de la operación.
El éxito:
- 200 OK : «Dispositivo guardado con éxito»
Error:
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 401 No autorizado : {«Mensaje»: «Clave errónea inválida»}
- 404 No se encuentra : {«Mensaje»: «DeviceGUID no se encuentra»}
- 415 Tipo de medio no soportado : {«Mensaje»: «Esta solicitud no tiene el formato adecuado»}
- 401 No autorizado : {«Mensaje»: «»MisKey» o «HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 400 Bad Request : {«Mensaje»: «DeviceGUID» requerido»}
- 400 Bad Request : {«Mensaje»: «ComputerGUID» requerido»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Cola de espera para añadir/actualizar
Si cualquier cola con QueueGUID se actualiza la cola, en caso contrario se añade una nueva cola.
URL:
POST http://api.aurelon.com/
api/v2/configuration/queue
Cabeceras de solicitud:
Tipo de contenido : application/json
MisKey : ver Autenticación
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Cuerpo de la solicitud:
Objeto JSON que contiene:
- QueueGUID – requerido – el GUID de la cola
- DeviceGUID – requerido
- Nombre del perfil
- Nombre
- MediaType
- MediaSize
- MediaSource
- Tipo de cola
- DriverSettings
Respuesta:
Tipo de contenido application/json que contiene el resultado de la operación.
El éxito:
- 200 OK : «Cola guardada con éxito»
Error:
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 401 No autorizado : {«Mensaje»: «Clave errónea inválida»}
- 404 No se encuentra : {«Mensaje»: «DeviceGUID no se encuentra»}
- 415 Tipo de medio no soportado : {«Mensaje»: «Tipo esperado: application/json»}
- 401 No autorizado : {«Mensaje»: «»MisKey» o «HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 400 Bad Request : {«Mensaje»: «DeviceGUID» requerido»}
- 400 Bad Request : {«Mensaje»: «QueueGUID» requerido»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Borrar dispositivo
Eliminar el dispositivo especificado.
URL:
DELETE http://api.aurelon.com/
api/v2/configuration/device/<DeviceGUID>
Cabeceras de solicitud:
Tipo de contenido : application/json
MisKey : ver Autenticación
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Respuesta:
Tipo de contenido application/json que contiene el resultado de la operación.
El éxito:
- 200 OK : «Dispositivo eliminado con éxito»
Error:
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 401 No autorizado : {«Mensaje»: «Clave errónea inválida»}
- 404 No se encuentra : {«Mensaje»: «DeviceGUID no se encuentra»}
- 401 No autorizado : {«Mensaje»: «»MisKey» o «HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 400 Bad Request : {«Mensaje»: «DeviceGUID» valor requerido»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}
Borrar la cola
Elimina la cola especificada.
URL:
DELETE http://api.aurelon.com/
api/v2/configuration/queue/<QueueGUID>
Cabeceras de solicitud:
Tipo de contenido : application/json
MisKey : ver Autenticación
HardwareHash : ver Autenticación
Número de serie : ver Autenticación
AplicaciónVersión : ver Autenticación
Respuesta:
Tipo de contenido application/json que contiene el resultado de la operación.
El éxito:
- 200 OK : «Dispositivo eliminado con éxito»
Error:
- 401 No autorizado : {«Mensaje»: «HardwareHash inválido»}
- 401 No autorizado : {«Mensaje»: «Clave errónea inválida»}
- 404 No se encuentra : {«Mensaje»: «No se encuentra el QueueGUID»}
- 401 No autorizado : {«Mensaje»: «»MisKey» o «HardwareHash», «SerialNumber» y «ApplicationVersion» son obligatorios»}
- 400 Bad Request : {«Mensaje»: «QueueGUID» valor requerido»}
- 500 Internal Server Error : {«Mensaje»: «Error interno del servidor»}