Actualizar o estado do dispositivo para reflectir o estado actual. O estatuto é transitório, pelo que substitui o último estatuto registado.
URL:
POST http://api.aurelon.com/api/v2/device/status
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 – string necessária – o Guia do Dispositivo
- Estado – cadeia requerida – uma de “Erro”, “Ocioso”, “Offline”, “Impressão”, “Abortar”, “Dormir”, “Calibrar”.
- Mensagem – string – Mensagem de estado de leitura humana de forma livre
- Temperatura – número – temperatura do aquecedor em celsius
- ConnectionState – string – estado das mensagens PING, uma de “Online”, “Offline”, “Unstable”.
- ConnectionMessage – string – Mensagem de estado de ligação de leitura humana de forma livre
- RestainingInks – conjunto de objectos – Objectos contendo para cada tinta:
- InkIndex – número requerido – índice de sequência da tinta
- InkName – fio necessário – Nome da cor da tinta
- Nível – número requerido – quantidade actual de ml do tanque, <0 indica desconhecido
- MaxLevel – número necessário – quantidade máxima de ml do tanque
- QueueLength – objecto necessário – Contendo um dos seguintes elementos:
- Comprimento – número – Comprimento dos trabalhos em unidades para um dispositivo rolo a rolo
- Área – número – Área dos trabalhos em unidades-sq para um dispositivo rígido
- Folhas – número – Quantidade de folhas para um dispositivo de alimentação de folhas
Exemplo:
{ "DeviceGUID": "af4da7ba-23be-11e5-850d-f3773dfc73c9", "Status": "Sleeping", "Message": "", "ConnectionState": "Unstable", "ConnectionState": "The connection with the printer is not stable.", "Temperature": 30, "RemainingInks": [ { "InkName": "Magenta", "Level": 606, "MaxLevel": 775 }, { "InkName": "Light magenta", "Level": 624, "MaxLevel": 775 }, { "InkName": "Light cyan", "Level": 661, "MaxLevel": 775 }, { "InkName": "Cyan", "Level": 565, "MaxLevel": 775 }, { "InkName": "Latex Optimizer", "Level": 668, "MaxLevel": 775 }, { "InkName": "Yellow", "Level": 575, "MaxLevel": 775 }, { "InkName": "Black", "Level": 589, "MaxLevel": 775 }, { "InkName": "CleanKit", "Level": 75, "MaxLevel": 100 } ] }
Resposta:
Aplicação do tipo de conteúdo/json contendo o resultado da operação.
O sucesso:
200 OK : “Estado do dispositivo actualizado com sucesso”
Erro:
- 401 Não Autorizado : {“Mensagem”: “Invalid HardwareHash”}
- 401 Não Autorizado : {“Mensagem”: “Inválida 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 Bad Request : {“Mensagem”: Valor “DeviceGUID” requerido”}
- 500 Erro do Servidor Interno : {“Mensagem”: “Erro do Servidor Interno”}