Riferimento API entopizo
GPS tracking per veicoli e flotte

Introduzione

L'API di entopizo è un'API REST convenzionale. Ogni richiesta (eccetto login) è autenticata con un token user_api_hash passato come parametro. Non ci sono SDK da installare — qualsiasi client HTTP funziona.

Avvio rapido: la vostra prima richiesta in 60 secondi

curl -X POST "https://go.entopizo.gr/api/login" \
  -d "email=user@example.com" \
  -d "password=••••••••"

# → { "status": 1, "user_api_hash": "$2y$10$..." }

curl "https://go.entopizo.gr/api/get_devices?user_api_hash=HASH&lang=en"

Autenticazione

L'autenticazione utilizza un token statico per utente, il user_api_hash. Viene rilasciato una volta tramite login e poi passato come parametro in ogni chiamata. Le intestazioni Bearer non vengono utilizzate. Il token non scade a meno che la password dell'account non venga modificata.

curl -X POST "https://go.entopizo.gr/api/login" \
  -d "email=user@example.com" \
  -d "password=••••••••"

{
  "status": 1,
  "user_api_hash": "$2y$10$EXAMPLEHASH..."
}

Convenzioni

Formati utilizzati in modo coerente in tutta l'API:

Le unità di distanza e capacità (km/mi, litri/galloni) seguono le impostazioni dell'account — vedere Account & Setup.

Dispositivi

Un dispositivo è un GPS tracker installato in un veicolo o in un bene. Gli oggetti dispositivo riportano l'ultima posizione conosciuta, lo stato di movimento e i valori dei sensori, quindi per domande del tipo "dove si trova la mia flotta in questo momento" è sufficiente una singola chiamata.

curl "https://go.entopizo.gr/api/get_devices?user_api_hash=HASH&lang=en"

[
  {
    "id": 0,
    "title": "Ungrouped",
    "items": [
      {
        "id": 1042,
        "name": "Truck YZX-1234",
        "online": "online",
        "time": "05-07-2026 14:32:10",
        "speed": 54,
        "course": 118,
        "lat": 37.97552,
        "lng": 23.73481,
        "altitude": 92,
        "address": "132 Gr. Lampraki Ave, Korydallos",
        "protocol": "teltonika",
        "total_distance": 48211.7,
        "stop_duration": "0s",
        "sensors": [
          { "name": "Ignition", "value": "On" },
          { "name": "Battery", "value": "12.6V" }
        ],
        "tail": [
          { "lat": "37.97501", "lng": "23.73390" }
        ]
      }
    ]
  }
]

Altri endpoint dei dispositivi

Tutti accettano user_api_hash.

Cronologia del percorso

curl "https://go.entopizo.gr/api/get_history?user_api_hash=HASH\
&device_id=1042&from_date=2026-07-04&from_time=00:00\
&to_date=2026-07-04&to_time=23:59"

{
  "distance_sum": "182.4 km",
  "top_speed": "96 kph",
  "items": [
    {
      "status": 1,
      "distance": 42.7,
      "time": "1h 05min",
      "items": [
        { "lat": 37.975, "lng": 23.734,
          "speed": 51, "time": "08:12:04" }
      ]
    },
    {
      "status": 3,
      "time": "38min",
      "location": "Warehouse, Aspropyrgos"
    }
  ]
}

Altri endpoint di cronologia

Eventi

Gli eventi sono occorrenze registrate per un dispositivo: eccesso di velocità, ingresso/uscita da geofence, interruzione di alimentazione, traino, SOS e altro. Gli eventi vengono generati solo quando è attiva una regola di allarme corrispondente.

{
  "items": {
    "data": [
      {
        "id": 88211,
        "device_id": 1042,
        "type": "overspeed",
        "message": "Speed limit exceeded",
        "speed": 112,
        "latitude": 38.0142,
        "longitude": 23.6650,
        "address": "Athinon Ave, Athens",
        "time": "04-07-2026 16:44:31"
      }
    ],
    "current_page": 1,
    "last_page": 4
  }
}

Altri endpoint degli eventi

Regole di avviso

Le regole di avviso definiscono quando vengono generati gli eventi e come l'utente viene notificato (push, email, SMS).

curl -X POST "https://go.entopizo.gr/api/add_alert" \
  -d "user_api_hash=HASH" \
  -d "name=Overspeed 100 km/h" \
  -d "type=overspeed" \
  -d "overspeed=100" \
  -d "devices[]=1042" \
  -d "devices[]=1043"

{ "status": 1 }

Altri endpoint di avviso

Geofence e percorsi

Le geofence sono aree denominate (poligoni o cerchi) utilizzate per gli avvisi di entrata/uscita e per la reportistica. I percorsi sono tragitti predefiniti che un veicolo dovrebbe seguire.

curl -X POST "https://go.entopizo.gr/api/add_geofence" \
  -d "user_api_hash=HASH" \
  -d "name=Warehouse Aspropyrgos" \
  -d 'polygon=[{"lat":38.061,"lng":23.593},
              {"lat":38.062,"lng":23.601},
              {"lat":38.057,"lng":23.600}]'

{ "status": 1 }

Altri endpoint per geofence e percorsi

Comandi

I comandi sono messaggi inviati al tracker tramite GPRS o SMS — ad esempio l'arresto/la ripresa del motore nelle installazioni supportate. I tipi di comando disponibili dipendono dal protocollo del dispositivo.

curl -X POST "https://go.entopizo.gr/api/send_gprs_command" \
  -d "user_api_hash=HASH" \
  -d "device_id=1042" \
  -d "type=custom" \
  -d "data=setdigout 1"

{ "status": 1, "message": "Command sent" }

Altri endpoint di comando

Report

Genera report — generali, guide e soste, comportamento del conducente, carburante, eccesso di velocità, attività del geofence e altro ancora — in HTML, PDF o XLS, oppure li pianifica per la consegna automatica.

curl -X POST "https://go.entopizo.gr/api/generate_report" \
  -d "user_api_hash=HASH" \
  -d "title=June mileage" \
  -d "type=1" \
  -d "devices[]=1042" \
  -d "date_from=2026-06-01 00:00" \
  -d "date_to=2026-06-30 23:59" \
  -d "format=html"

{
  "status": 1,
  "url": "https://go.entopizo.gr/report/…"
}

Altri endpoint per i report

Conducenti

I conducenti possono essere assegnati ai dispositivi manualmente oppure identificati automaticamente tramite RFID / iButton. L'identità del conducente compare quindi nella cronologia, negli eventi e nei report.

Sensori

I sensori traducono i parametri grezzi del protocollo in valori leggibili: accensione, livello del carburante, temperatura, stato della porta, tensione della batteria e altro ancora. I valori dei sensori appaiono all'interno delle risposte get_devices.

Manutenzione

Gli elementi di manutenzione (servizi) tracciano gli obblighi ricorrenti del veicolo — manutenzione, cambio olio, revisione del veicolo, assicurazione — in base al contachilometri, alle ore motore o ai giorni di calendario, con avvisi di scadenza.

Attività

Le attività rappresentano lavori o consegne assegnati a un veicolo, con dettagli di ritiro/consegna, priorità e monitoraggio dello stato.

Account e configurazione

Condivisione, media, azioni di chiamata e geocodifica

Condivisione — link di posizione in tempo reale

Link pubblici temporanei per condividere la posizione in tempo reale di un veicolo con terze parti (ad es. un cliente in attesa di una consegna).

Media — tracker dotati di telecamera

Azioni di chiamata — avvisi tramite chiamata vocale

Alimenta la funzione entopizo instant call: trasforma eventi selezionati in notifiche automatiche tramite chiamata telefonica invece di (o insieme a) push/email.

Geocoding

Icone della mappa e POI

Errori e limiti

Le chiamate riuscite restituiscono HTTP 200 con "status": 1. I fallimenti restituiscono "status": 0 nel corpo, oppure un codice di errore HTTP.

Esempio di errore

{
  "status": 0,
  "message": "Wrong email or password"
}

Guida per gli agenti IA

Questa sezione si rivolge agli agenti basati su LLM (Claude, ChatGPT, assistenti personalizzati) che utilizzano l'API tramite server MCP o function calling.

Flusso consigliato

1. Chiamate get_devices una volta per mappare i nomi dei veicoli su device_id. 2. Utilizzate device_id per la cronologia, gli eventi, i sensori o i comandi. 3. Per domande sulla posizione attuale, i dati di get_devices sono sufficienti — non è necessaria una seconda chiamata.

Efficienza dei token

Le risposte di get_devices e get_history sono ampie. Mantenete solo i campi id, name, online, time, speed, lat, lng, address e, nella cronologia, gli aggregati per segmento (distance, time, status, location) invece dei punti GPS grezzi.

Sicurezza e consenso

Non memorizzate mai le credenziali nei prompt. Le chiamate a send_gprs_command o a qualsiasi endpoint di eliminazione richiedono la conferma esplicita dell'utente. I dati di localizzazione sono dati personali secondo il GDPR — non esponeteli a terzi.