Esta rota inicia a execução de um comando remoto para um único veículo específico. A execução do comando ocorre em segundo plano. Use a rota GET /vehicle-command/{command_id} para verificar o status do comando.
Os comandos de ignição enable_ignition e disable_ignition exigem confirmação em duas etapas. Na primeira chamada (sem o campo code), o comando não é executado: a resposta retorna status: "Confirmation" com um code de 6 dígitos e uma message para exibir ao usuário. Para executar, reenvie a mesma requisição incluindo o code recebido. Os demais comandos executam em chamada única.
Assinatura HMAC SHA256 do corpo da requisição, usando o sign-secret da aplicação como chave. O corpo deve ser serializado em JSON sem espaços extras e com chaves ordenadas alfabeticamente antes de gerar a assinatura. Veja o exemplo a seguir:
Indica o código de confirmação de 6 dígitos retornado na primeira etapa dos comandos de ignição (enable_ignition e disable_ignition). Informe-o para executar o comando na segunda chamada. Não se aplica aos demais comandos.
Indica o identificador único (UUID) do comando registrado no sistema da mobway. Use este ID para verificar o status do comando posteriormente em GET /vehicle-command/{command_id}.
Indica o status inicial do comando. Pode ser “Confirmation”, quando um comando de ignição aguarda a segunda etapa de confirmação (reenvio com o code), “Pending”, em que o comando ainda não foi processado, ou “Error”, quando o comando não foi executado corretamente.
Indica o código de confirmação de 6 dígitos. Presente apenas na resposta de confirmação (status: "Confirmation") dos comandos de ignição. Reenvie a requisição com este valor no campo code para executar o comando.
Indica a cause do erro na requisição. Esse campo só estará presente em caso de falha na requisição.
“Invalid VIN. VIN must be a string. At least one VIN is required.”: A requisição está mal formada pela falta do parâmetro obrigatório vin.
“Invalid command. Command must be a string. At least one command is required.”: A requisição está mal formada pela falta do parâmetro obrigatório command.
“VIN not found or unauthorized access.”: O VIN solicitado é inválido, não está associado à sua empresa, ou o tipo de propriedade do veículo não permite essa ação.
“Command not found or unauthorized access.”: O comando solicitado não está disponível para este veículo, seja por restrições do OEM ou por não estar incluído no seu plano de pacotes.
“Sign-secret not found.”: A assinatura HMAC fornecida no header X-Signature não corresponde a nenhum aplicação relacionada a empresa.
“X-Signature invalid.”: A assinatura HMAC fornecida no header X-Signature não corresponde à assinatura calculada com base no corpo da requisição.
“Failed to send command to the OEM.”: Ocorreu um erro ao tentar enviar o comando para o sistema da OEM.
“Failed to initiate command with the OEM or retrieve status URL.”: Ocorreu um erro ao iniciar o comando com o OEM ou ao obter a URL necessária para verificar o status posteriormente.
“Confirmation invalid”: O código de confirmação informado é inválido. Reinicie o fluxo enviando a requisição sem o campo code para obter um novo código.
“Confirmation already used”: O código de confirmação já foi utilizado. Cada código é de uso único. Reinicie o fluxo enviando a requisição sem o campo code para obter um novo.
