GET /iwatch/devices/trackers

Retorna a lista paginada de dispositivos rastreados a partir da view do cliente autenticado. Sem parâmetros, devolve todos os registros disponíveis na view; com filter, restringe pela data de carga (dt_carga).

Este endpoint pode retornar mais de uma linha por dispositivo (corresponde ao conjunto de registros carregados). Se você precisa de uma "foto" com um único registro por dispositivo, use /iwatch/devices/trackers/snapshot.

Autenticação

Requer header ifw-public-hub-key. Ver Visão Geral para detalhes.

Request

Headers

Header	Valor
ifw-public-hub-key	<api-key-do-cliente>

Query Parameters

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
filter	string	—	—	Filtro de data no formato date:eq:YYYY-MM-DD. Aplicado em dt_carga.
page	int	—	1	Página (≥ 1).
pageSize	int	—	20	Itens por página (1–100).

# Página 1 com 20 itens
curl -s "https://servicos.ifollowtech.com.br/iwatch/devices/trackers?page=1&pageSize=20" \
  -H "ifw-public-hub-key: <api-key>"

# Filtrando pelo dia da carga
curl -s "https://servicos.ifollowtech.com.br/iwatch/devices/trackers?filter=date:eq:2026-05-12" \
  -H "ifw-public-hub-key: <api-key>"

Response

200 OK

{
  "page": 1,
  "pageSize": 20,
  "total": 150,
  "data": [
    {
      "dispositivo": "iWatch-001",
      "material": "MAT-12345",
      "identificador": 123456,
      "cnpj": "12.345.678/0001-90",
      "planejado": true,
      "endereco": null,
      "latitude": 0.0,
      "longitude": 0.0,
      "ligado": true,
      "sem_sinal": false,
      "desligado": false,
      "em_estoque": false,
      "nao_positivado": false,
      "alerta_inicial": false,
      "alerta_moderado": false,
      "alerta_critico": false,
      "imei": 123456789012345,
      "data_de_captura": "2026-05-12",
      "hora_de_captura": "14:30:00",
      "data_de_ping": "2026-05-12",
      "hora_de_ping": "14:30:05",
      "data_de_positivacao": "2026-05-12",
      "hora_de_positivacao": "10:12:00",
      "data_de_recebimento": "2026-05-11",
      "nome_do_pdv": "Loja Centro",
      "canal": "Varejo",
      "regiao": "Sudeste",
      "projeto": "Projeto Alfa",
      "loja_alvo": "Loja Alvo 1",
      "cnpj_da_loja": "11.111.111/0001-11",
      "razao_social_da_loja": "Comércio LTDA",
      "nome_fantasia_da_loja": "Comércio",
      "rede": "Rede X",
      "rua_positivacao": "Rua Exemplo",
      "cep_positivacao": "01000-000",
      "cidade_positivacao": "São Paulo",
      "estado_positivacao": "SP",
      "bairro_positivacao": "Centro",
      "logradouro_positivacao": "Rua",
      "numero_positivacao": "100",
      "complemento_positivacao": null,
      "latitude_positivacao": "-23.55052",
      "longitude_positivacao": "-46.633308",
      "latitude_rastreada": "-23.55052",
      "longitude_rastreada": "-46.633308",
      "endereco_rastreado": "Rua Exemplo, 100",
      "data_captura": "2026-05-12",
      "hora_captura": "14:30:00",
      "emails_para_notificar": "ops@example.com",
      "perc_bateria": 85,
      "categoria": "Tracker"
    }
  ]
}

Envelope

Campo	Tipo	Descrição
page	int	Página atual.
pageSize	int	Tamanho da página.
total	int	Total de registros que satisfazem o filtro.
data	array	Itens da página.

400 Bad Request

Retornado quando page, pageSize ou filter são inválidos.

403 Forbidden

API Key ausente/inválida ou cliente sem nenhuma view permitida.

No views available for this client