Para acessar a API de clientes, é preciso um token para autenticação. Favor verificar com a empresa do serviço de rastreamento o token para autenticação.
Para este exemplo vamos tomar como base a URL = https://portal.rastreamos.app e vamos passar o token no header da solicitação com o atributo token.
- Listagem de veículos
Para listagem dos veículos do cliente, utilize a rota URL + “/api/public/list” no modo GET.
Será retornado uma listagem de veículos com os campos a seguir:
- uuid = A identificação do veículo
- plate = A placa do veículo.
- Listagem das posições
Para listar as posições, será preciso fazer uma chamada a api na seguinte rota URL + “/api/public/positions/{uuid}/{timestamp}” onde a uuid será a identificação do veículo e o timestampo será o unix timestamp da data inicial.
As posições sempre retornarão um limite de 20 posições.
Será retornado os seguintes campos:
- id = Identificação da posição.
- proximity = Localização da posição
- date = Data da posição no formato YYYY-MM-DD HH:mm:ss
- gps_is_valid = informação se o GPS do rastreador esta válido.
- odometer = Hodômetro do veículo
- ignition = Ignição do veículo ON para ligado e OFF para desligado.
- latlong.latitude = Latitude da posição
- latlong.longitude = Longitude da posição
- speed = Velocidade do veículo na posição
- driver = Nome do motorista caso tenha cadastrado.
- XML ou JSON
Por padrão a resposta é retornada em JSON, mas é possível retornar em XML. Basta adicionar um acrescimo na rota para retornar um xml. Por exemplo: ?method=xml