Skip to main content
GET
Use esta rota para verificar o status de um comando que foi iniciado através da rota POST /vehicle-command.

​
Request

Header
​
string
obrigatório
É o token ao portador utilizado para autenticar a empresa.
Path Parameters
​
string
obrigatório
O identificador único (UUID) do comando, retornado na resposta da requisição POST /vehicle-command.

​
Response

​
string
Indica o identificador único (UUID) do comando registrado no sistema da mobway.
​
string
Indica o número de identificação único do veículo.
​
string
Indica o comando que foi solicitado.
​
string
Indica o status atual do comando. Pode ser “Pending”, em que o comando ainda não foi processado, “Success”, quando o comando foi executado corretamente, ou “Error”, quando o comando não foi executado corretamente.
​
json object or string
Indica detalhes adicionais sobre o resultado do comando. Em caso de sucesso, pode conter um objeto com informações retornadas pelo veículo. Em caso de erro, geralmente contém um texto com a descrição do erro, conforme a descrição abaixo. Será um objeto vazio enquanto o comando ainda estiver “Pending” ou quando o comando não retornar nenhuma informação adicional.
  • Erros na Requisição. Ocorrem quando há um problema entre o cliente o servidor da mobway, por exemplo uma requisição mal formada ou com acesso negado.
    • “Invalid command ID. Command ID must be a string. At least one command ID is required.”: A requisição está mal formada pela falta do parâmetro obrigatório command_id.
    • “Command not found.”: O command_id fornecido não corresponde a nenhum comando registrado.
    • “Access denied.”: O comando solicitado pertence a uma aplicação diferente daquela associada ao token de autenticação utilizado.
  • Erros no Comando. Ocorrem quando há um problema entre o servidor da mobway e da montadora ou entre a montadora e o veículo, por exemplo quando o comando não consegue ser executado por estar fora da área de cobertura do sinal.
    • “Command timeout.”: A requisição não conseguiu ser executada no tempo pré-determinado ou não obteve a resposta esperada do veículo.
    • “Commands blocked.”: Comando recusado porque o veículo está em estado incompatível (ex: em movimento) ou não possui capacidade para processá-lo.
    • “Commands restrictions.”: Comando não conseguiu ser executado completamente (ex: geolocalização do veículo está oculta por privacidade).
    • “Communication failures.”: Conexão interrompida ou instável entre a rede e o veículo, impedindo troca de dados (ex: sinal fraco, falha de protocolo).
    • “Data retrieval failures.”: Dados recebidos estão parcialmente disponíveis ou não foram coletados devido a erros de transmissão.
    • “Internal system failures.”: Serviço fora do ar temporariamente ou erro crítico em processos internos.
    • “Invalid input.”: Comando enviado inclui informações inválidas, incompletas ou opções não reconhecidas.
    • “Unauthorized access.”: Sessão expirada ou tentativa de acesso a recursos restritos sem privilégios adequados.
    • “Unsupported commands.”: Funcionalidade indisponível para o modelo ou falta de autorização para ação.
​
datetime
Indica a data e hora da última atualização do status do comando no sistema da mobway [YYYY-MM-DD HH:MM:SS] (UTC-3). Se o valor for igual ao created em POST /vehicle-command, quer dizer que o comando ainda não teve nenhuma atualização no sistema da mobway.
Os três valores de data e hora por comando são:
  • created: quando o comando foi registrado no sistema da mobway (POST /vehicle-command)
  • date_time: quando o comando foi executado pelo veículo
  • updated: quando a mobway recebeu a resposta do comando