Os comandos enable_ignition e disable_ignition dependem da área de cobertura do sinal de telefonia para comunicação com o veículo. É fundamental assegurar que o veículo esteja acessível e conectado antes de enviar qualquer um desses comandos. Caso um deles seja executado e o veículo fique fora da área de cobertura, poderá ser necessária uma intervenção física.
Por segurança, 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", 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. Detalhes em POST vehicle-command.Exemplo da resposta da primeira etapa (confirmação):{
"id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
"vin": "6AHFT68CKAF501652",
"command": "disable_ignition",
"status": "Confirmation",
"code": "559289",
"message": "<mensagem de alerta retornada pela API>"
}
Requisitos e responsabilidades de uso (desativação de ignição)A desativação remota da ignição é uma funcionalidade sensível. Ao utilizá-la, a sua empresa é responsável por garantir que:
- O acesso aos comandos de ignição seja restrito a usuários autorizados, não liberado a todos os usuários.
- O comando seja iniciado apenas pela sua empresa, e não por terceiros.
- O veículo seja de propriedade da sua empresa, alugado, ou esteja legalmente sob a sua frota.
- Haja consentimento do usuário final do veículo.
- O uso se restrinja a situações em que o veículo esteja desaparecido, com suspeita razoável de furto ou roubo, ou em uso não autorizado.
- Seus procedimentos internos tenham sido concluídos antes do envio, incluindo, quando aplicável, a tentativa de localizar o veículo pelas APIs disponíveis, conforme a legislação aplicável.
- Tenha havido uma tentativa de notificar o usuário final antes do envio.
- Tenham sido feitos esforços razoáveis para confirmar que a desativação pode ser concluída com segurança.
Após desativar, reative a ignição (enable_ignition) assim que não for mais seguro ou necessário manter o veículo desativado. enable_ignition
Ativa ignição
- Descrição: habilita a ignição quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo).
- Pré-condições:
- O veículo precisa estar desligado.
- A ignição do veículo precisa ter sido desabilitada previamente por comando remoto.
- Exemplo:
{
"id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
"vin": "6AHFT68CKAF501652",
"command": "enable_ignition",
"status": "Success",
"detail": {
"date_time": "2023-02-14 09:52:48"
},
"updated": "2023-02-14 09:53:48"
}
disable_ignition
Desativa ignição
- Descrição: desabilita a ignição quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo). Um aviso será mostrado no painel do veículo.
- Pré-condições:
- O veículo precisa estar desligado.
- Exemplo:
{
"id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
"vin": "6AHFT68CKAF501652",
"command": "disable_ignition",
"status": "Success",
"detail": {
"date_time": "2023-02-14 09:52:48"
},
"updated": "2023-02-14 09:53:48"
}
start
Aciona remotamente
- Descrição: aciona remotamente quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo).
- Pré-condições:
- O capô do motor deve estar fechado.
- O tanque de combustível não deve estar na reserva.
- A tensão da bateria deve estar em níveis adequados.
- O pisca-alerta não deve estar ligado.
- A transmissão deve estar na posição de “Park” (P).
- Não deve haver luzes de anomalia no painel do veículo.
O veículo não deve ter realizado mais de duas partidas remotas consecutivas com sucesso. Para que a próxima partida remota seja bem-sucedida, o cliente deve ligar o carro fisicamente antes de tentar novamente.
{
"id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
"vin": "6AHFT68CKAF501652",
"command": "start",
"status": "Success",
"detail": {
"date_time": "2023-02-14 09:52:48"
},
"updated": "2023-02-14 09:53:48"
}
cancel_start
Cancela acionamento remoto
- Descrição: cancela o acionamento remoto do veículo enviando anteriormente ou desliga o veículo caso ele tenha sido ligado via comando remoto e não tenha ligado a ignição manualmente.
- Pré-condições:
- O veículo precisa ter sido acionado remotamente previamente por comando remoto.
- Exemplo:
{
"id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
"vin": "6AHFT68CKAF501652",
"command": "cancel_start",
"status": "Success",
"detail": {
"date_time": "2023-02-14 09:52:48"
},
"updated": "2023-02-14 09:53:48"
}
