Adicionar/actualizar ficheiro de configuração RIP
As configurações RIP estão ligadas a um computador específico, identificado pela sua ComputerGUID. Se algum ficheiro de configuração RIP com o ComputerGUID é encontrado, o ficheiro de configuração RIP é actualizado, caso contrário é adicionado um novo ficheiro de configuração RIP.
URL:
PÓS http://api.aurelon.com/api/v2/
configuração
Pedir cabeçalhos:
Content-Type : dados multipartes/formato
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Pedido de corpo:
Dados do formulário 1: necessário
-
- Nome: JsonString
- Tipo de conteúdo: aplicação/json
- {“ComputerGUID”:”00000000-0000-0000-0000-000000000000″} O GUID do computador RIP é aprovado como ComputerGUID
Dados do formulário 2: necessário
-
- Nome: RIP.xml (elemento de ficheiro de entrada pode ter qualquer nome)
- Tipo de conteúdo: aplicação/xml
- O ficheiro XML da configuração
Resposta:
O tipo de conteúdo da resposta está no formato JSON
O sucesso:
- 200 OK : “Configuração adicionada com sucesso
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 415 Tipo de meios de comunicação não suportados : {“Mensagem”: “Este pedido não está devidamente formatado”}
- 401 Não autorizado : {“Mensagem”: “”HardwareHash”, “SerialNumber” e cabeçalho “ApplicationVersion” são necessários”}
- 400 Mau Pedido : {“Mensagem”:””ComputerGUID” necessário”}
- 400 Mau Pedido : {“Mensagem”: “Validação de ComputerGUID falhou”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Exemplo de ficheiro de configuração XML:
aqui
Obter Configuração
Descarrega o ficheiro de configuração RIP com ComputerGUID se encontrado.
URL:
GET http://api.aurelon.com/api/v2/
configuração/<ComputerGUID>
Pedir cabeçalhos:
MisKey : ver Autenticação
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Resposta:
O tipo de conteúdo é aplicação/xml e contém o XML da configuração do computador RIP. Ou tipo de aplicação de conteúdo/json quando com o conteúdo de erro.
O sucesso:
- 200 OK : Configuração XML
Erro:
- 401 Não Autorizado : {“Mensagem”: “Inválida MisKey”}
- 401 Não Autorizado : {“Mensagem”:””HardwareHash” cabeçalho é inválido”}
- 404 Não Encontrado : {“Mensagem”: “ComputerGUID não encontrado”}
- 401 Não Autorizado : {“Mensagem”: “”MisKey” ou “HardwareHash”, cabeçalho “SerialNumber” e “ApplicationVersion” são necessários”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Obter Lista de Sítios
Recebe a lista de sítios activos identificados pelo seu número de série
URL:
GET http://api.aurelon.com/
api/v2/configuração/sites
Pedir cabeçalhos:
MisKey : ver Autenticação
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Resposta:
Tipo de aplicação de conteúdo/json e contém o JSON dos sítios conhecidos identificados pelo número de série.
O sucesso:
- 200 OK : Conjunto de sítios
Ex:
[{
“SiteGUID”:”8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
“SerialNumber”:333674,
“Localização”:nulo,
}, {
…
}]
Erro:
- 401 Não Autorizado : {“Mensagem”: “Inválida MisKey”}
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 401 Não Autorizado : {“Mensagem”: “”MisKey” ou “HardwareHash”, cabeçalho “SerialNumber” e “ApplicationVersion” são necessários”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Obter Configuração do Sítio
Recebe a lista de dispositivos/filas activas e RIPs do número de série
URL:
GET http://api.aurelon.com/
api/v2/configuração/site/<SerialNumber>
Pedir cabeçalhos:
MisKey : ver Autenticação
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Resposta:
Tipo de aplicação de conteúdo/json e contém o JSON das configurações conhecidas no local identificado pelo número de série.
O sucesso:
- 200 OK : Conjunto de computadores, os seus dispositivos e as suas filas de espera.
Ex:
[{
“ComputerGUID”:”8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
“Nome”: “myrip.company.domain”,
“Modified”:”2018-06-27T07:56:36Z”,
“Dispositivos”:[{ {
“DeviceGUID”:”6da06b44-20ee-11e6-b287-07f164aa386e”,
“Nome”: “Durst Rhotex 322”,
“Modified”:”2018-06-27T07:56:36Z”,
“DriverID”:1601
}, {
…
}]
}, {
…
}]
Erro:
- 401 Não Autorizado : {“Mensagem”: “Inválida MisKey”}
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 404 Não Encontrado : {“Mensagem”: “SerialNumber não encontrado”}
- 401 Não Autorizado : {“Mensagem”: “”MisKey” ou “HardwareHash”, cabeçalho “SerialNumber” e “ApplicationVersion” são necessários”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Sincronização da configuração
Actualização da lista de dispositivos/filas activos num RIP
URL:
POST http://api.aurelon.com/
api/v2/configuração/sync
Pedir cabeçalhos:
Content-Type : aplicação/json
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Pedido de corpo:
Objecto JSON contendo:
- ComputerGUID – necessário – o GUIA DO INFORMÁTICA
- DeviceList – necessário – Conjunto de objectos por dispositivo. Cada objecto contendo:
- DeviceGUID – necessário – GUIA DE DISPOSITIVOS activos no RIP
- QueueList – Conjunto de guias de filas activas no RIP
Resposta:
Aplicação do tipo de conteúdo/json contendo o resultado da operação.
O sucesso:
- 200 OK : “Configuração guardada com sucesso”
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 415 Tipo de meios de comunicação não suportados : {“Mensagem”: “Este pedido não está devidamente formatado”}
- 401 Não Autorizado : {“Mensagem”: “”HardwareHash”, “SerialNumber” e cabeçalho “ApplicationVersion” são necessários”}
- 400 Mau Pedido : {“Mensagem”:””ComputerGUID” requerido”}
- 400 Mau Pedido : {“Mensagem”:” campo “DeviceList” é obrigatório”}
- 400 Mau Pedido : {“Mensagem”:” O campo “QueueList” é obrigatório”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Adicionar/actualizar RIP
Se algum RIP com ComputerGUID é encontrado o RIP é actualizado, caso contrário é acrescentado um novo RIP.
URL:
POST http://api.aurelon.com/
api/v2/configuração/rip
Pedir cabeçalhos:
Content-Type : aplicação/json
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Pedido de corpo:
Objecto JSON contendo:
- ComputerGUID – necessário – o GUIA DO INFORMÁTICA
- ComputerName – nome do computador ou nome DNS
- OperatingSystem – tipo e versão de SO
Resposta:
Aplicação do tipo de conteúdo/json contendo o resultado da operação.
O sucesso:
- 200 OK : “Dados informáticos guardados com sucesso”
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 415 Tipo de meios de comunicação não suportados : {“Mensagem”: “Tipo esperado: aplicação/json”}
- 401 Não Autorizado : {“Mensagem”: “”HardwareHash”, “SerialNumber” e cabeçalho “ApplicationVersion” são necessários”}
- 400 Mau Pedido : {“Mensagem”:””ComputerGUID” requerido”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Adicionar/actualizar dispositivo
Se qualquer dispositivo com DeviceGUID é encontrado o dispositivo é actualizado, caso contrário é acrescentado um novo dispositivo se fizer parte da licença. Se o DeviceGUID não fizer parte da licença, é devolvido um erro.
URL:
POST http://api.aurelon.com/
api/v2/configuração/dispositivo
Pedir cabeçalhos:
Content-Type : aplicação/json
MisKey : ver Autenticação
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Pedido de corpo:
Objecto JSON contendo:
- DeviceGUID – necessário – o Guia do Dispositivo
- ComputerGUID – necessário – o RIP em que este dispositivo está instalado
- Nome
- Tipo
- MediaType
- MediaSize
- MediaSource
- Fabricante
- Modelo
- DriverID (identificação única do condutor a partir da base de dados HUB)
- ConnectionURI
Resposta:
Aplicação do tipo de conteúdo/json contendo o resultado da operação.
O sucesso:
- 200 OK : “Dispositivo guardado com sucesso”
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 401 Não Autorizado : {“Mensagem”: “Inválido MisKey”}
- 404 Não Encontrado : {“Mensagem”: “DeviceGUID não foi encontrado”}
- 415 Tipo de meios de comunicação não suportados : {“Mensagem”: “Este pedido não está devidamente formatado”}
- 401 Não Autorizado : {“Mensagem”: “”MisKey” ou “HardwareHash”, cabeçalho “SerialNumber” e “ApplicationVersion” são necessários”}
- 400 Mau Pedido : {“Mensagem”:””DeviceGUID” necessário”}
- 400 Mau Pedido : {“Mensagem”:””ComputerGUID” requerido”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Adicionar/actualizar fila
Se alguma fila com QueueGUID é encontrada a fila é actualizada, caso contrário é acrescentada uma nova fila.
URL:
POST http://api.aurelon.com/
api/v2/configuração/queue
Pedir cabeçalhos:
Content-Type : aplicação/json
MisKey : ver Autenticação
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Pedido de corpo:
Objecto JSON contendo:
- QueueGUID – necessário – o GUIA DE LIGA
- DeviceGUID – necessário
- ProfileName
- Nome
- MediaType
- MediaSize
- MediaSource
- QueueType
- DriverSettings
Resposta:
Aplicação do tipo de conteúdo/json contendo o resultado da operação.
O sucesso:
- 200 OK : “Fila de espera salva com sucesso”
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 401 Não Autorizado : {“Mensagem”: “Inválido MisKey”}
- 404 Não Encontrado : {“Mensagem”: “DeviceGUID não foi encontrado”}
- 415 Tipo de meios de comunicação não suportados : {“Mensagem”: “Tipo esperado: aplicação/json”}
- 401 Não Autorizado : {“Mensagem”: “”MisKey” ou “HardwareHash”, cabeçalho “SerialNumber” e “ApplicationVersion” são necessários”}
- 400 Mau Pedido : {“Mensagem”:””DeviceGUID” necessário”}
- 400 Mau Pedido : {“Mensagem”:””QueueGUID” requerido”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Apagar dispositivo
Eliminar o dispositivo especificado.
URL:
DELETE http://api.aurelon.com/
api/v2/configuração/dispositivo/<DeviceGUID>
Pedir cabeçalhos:
Content-Type : aplicação/json
MisKey : ver Autenticação
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Resposta:
Aplicação do tipo de conteúdo/json contendo o resultado da operação.
O sucesso:
- 200 OK : “Dispositivo apagado com sucesso”
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 401 Não Autorizado : {“Mensagem”: “Inválido MisKey”}
- 404 Não Encontrado : {“Mensagem”: “DeviceGUID não foi encontrado”}
- 401 Não Autorizado : {“Mensagem”: “”MisKey” ou “HardwareHash”, cabeçalho “SerialNumber” e “ApplicationVersion” são necessários”}
- 400 Mau Pedido : {“Mensagem”:””DeviceGUID” valor requerido”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}
Eliminar Fila de espera
Eliminar a fila especificada.
URL:
DELETE http://api.aurelon.com/
api/v2/configuration/queue/<QueueGUID>
Pedir cabeçalhos:
Content-Type : aplicação/json
MisKey : ver Autenticação
HardwareHash : ver Autenticação
SerialNumber : ver Autenticação
ApplicationVersion : ver Autenticação
Resposta:
Aplicação do tipo de conteúdo/json contendo o resultado da operação.
O sucesso:
- 200 OK : “Dispositivo apagado com sucesso”
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 401 Não Autorizado : {“Mensagem”: “Inválido MisKey”}
- 404 Não Encontrado : {“Mensagem”: “QueueGUID não se encontra”}
- 401 Não Autorizado : {“Mensagem”: “”MisKey” ou “HardwareHash”, cabeçalho “SerialNumber” e “ApplicationVersion” são necessários”}
- 400 Mau Pedido : {“Mensagem”:””QueueGUID” valor requerido”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}