POST
/
vehicle-command
curl --request POST \
  --url https://api.mobway.cloud/vehicle-command \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Signature: <signature>' \
  --header 'Content-Type: application/json' \
  --data '{
    "vin": "{vin}",
    "command": "{command}"
}'

{
  "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
  "vin": "6AHFT68CKAF501652",
  "command": "diagnostics",
  "status": "Pending",
  "created": "2023-02-14 09:51:48"
}

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.

​
Request

Header
​
Authorization
string
required

É o token ao portador utilizado para autenticar a empresa.

​
X-Signature
string
required

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:

data = {"vin": vin, "command": command}
body = json.dumps(data, separators=(",", ":"), sort_keys=True)
signature = hmac.new("SUA_SIGN_SECRET_FORNECIDA_PELA_MOBWAY", body.encode(), hashlib.sha256).hexdigest()
Body
​
vin
string
required

Indica o Vehicle Identification Number (VIN) do veículo para o qual o comando será enviado.

​
command
string
required

Indica o comando remoto que se deseja executar no veículo.

​
Response

​
id
string

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}.

​
vin
string

Indica o número de identificação único do veículo.

​
command
string

Indica o comando que foi solicitado.

​
status
string

Indica o status inicial 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. Geralmente será “Pending”.

​
created
datetime

Indica a data e hora em que o comando foi registrado no sistema da mobway [YYYY-MM-DD HH:MM:SS] (UTC-3).

​
detail
string

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.
curl --request POST \
  --url https://api.mobway.cloud/vehicle-command \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Signature: <signature>' \
  --header 'Content-Type: application/json' \
  --data '{
    "vin": "{vin}",
    "command": "{command}"
}'

{
  "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
  "vin": "6AHFT68CKAF501652",
  "command": "diagnostics",
  "status": "Pending",
  "created": "2023-02-14 09:51:48"
}