Riferimento entopizo
Localizzazione GPS per veicoli e flotte

Introduzione

entopizo è una classica API REST. Ogni richiesta (ad eccezione di accedi) viene autenticato con un user_api_hash token passato come parametro. Non è necessario installare alcun SDK: va bene qualsiasi client HTTP.

Guida rapida: la tua 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 "entopizo"

Autenticazione

L'autenticazione utilizza un token statico specifico per ogni utente, ovvero il user_api_hash. Viene generato una volta al momento dell'accesso e poi trasmesso come parametro su ogni chiamata. Non vengono utilizzate le intestazioni "Bearer". Il token non scade a meno che non venga modificata la password dell'account.

curl -X POST "entopizo" \
  -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 misura per la distanza e la capacità (km/mi, litri/galloni) seguono le impostazioni dell'account — vedi " Account e impostazioni".

Dispositivi

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

curl "entopizo"

[
  {
    "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

Accettano tutti user_api_hash.

Cronologia dei percorsi

curl "entopizo\
&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 punti di riferimento storici

Eventi

Gli eventi sono avvenimenti registrati relativi a un dispositivo: eccesso di velocità, ingresso/uscita da un’area delimitata, interruzione di corrente, traino, SOS e altro ancora. Gli eventi vengono generati solo quando è attiva una regola di allerta 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 dell'evento

Regole di avviso

Le regole di avviso definiscono quando vengono generati gli eventi e in che modo l'utente viene avvisato (notifiche push, e-mail, SMS).

curl -X POST "entopizo" \
  -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 allerta

Geofence e percorsi

I geofence sono aree definite (poligoni o cerchi) utilizzate per gli avvisi di ingresso/uscita e per la generazione di report. 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 punti di confine e di fine percorso

Comandi

I comandi sono messaggi inviati al localizzatore tramite GPRS o SMS — ad esempio, l'arresto o la riattivazione del motore nelle installazioni compatibili. I tipi di comando disponibili dipendono dal protocollo del dispositivo.

curl -X POST "entopizo" \
  -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

Rapporti

Genera report — generali, relativi a tragitti e soste, al comportamento dei conducenti, al consumo di carburante, agli eccessi di velocità, all’attività all’interno dei perimetri di geolocalizzazione e altro ancora — in formato HTML, PDF o XLS, oppure ne programma l’invio automatico.

curl -X POST "entopizo" \
  -d "user_api_hash=HASH" \
  -d "title=Chilometraggio di giugno" \
  -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 del rapporto

Autisti

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

Sensori

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

Manutenzione

Le voci di manutenzione (servizi) tengono traccia degli obblighi ricorrenti relativi al veicolo — tagliando, cambio dell'olio, revisione, assicurazione — in base al contachilometri, alle ore di funzionamento del motore o ai giorni di calendario, con avvisi di scadenza.

Compiti

Le attività rappresentano incarichi o consegne assegnati a un veicolo, con i dettagli relativi al ritiro e alla consegna, alla priorità e al monitoraggio dello stato.

Account e configurazione

Condivisione, media, inviti all'azione e geocodifica

Condivisione — link alle posizioni in tempo reale

Link pubblici temporanei per condividere la posizione in tempo reale di un veicolo con terzi (ad esempio, un cliente in attesa della consegna).

Media — localizzatori dotati di telecamera

Azioni relative alle chiamate — Avvisi di chiamata vocale

Attiva la funzione di chiamataentopizo : trasforma gli eventi selezionati in notifiche tramite chiamate telefoniche automatiche al posto (o in aggiunta) delle notifiche push o delle e-mail.

Geocodifica

Icone della mappa e punti di interesse

Errori e limiti

Le chiamate riuscite restituiscono un codice di stato HTTP 200 con "stato": 1. Errori restituiti "status": 0 nel corpo del messaggio, oppure un codice di errore HTTP.

Esempio di errore

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

Linee guida per gli agenti di intelligenza artificiale

Questa sezione tratta degli agenti basati su LLM (Claude, ChatGPT, assistenti personalizzati) che utilizzano l'API tramite server MCP o tramite chiamate di funzione.

Portata consigliata

1. Chiamata get_devices una volta per associare i nomi dei veicoli a id_dispositivo. 2. Utilizzare il id_dispositivo per la cronologia, gli eventi, i sensori o i comandi. 3. Per le domande relative alla posizione attuale, get_devices I dati sono sufficienti — non è necessaria una seconda chiamata.

Efficienza dei token

Risposte da get_devices e get_history sono di grandi dimensioni. Conservare solo i campi id, nome, online, ora, velocità, lat, lng, indirizzo, e nella cronologia gli aggregati per segmento (distanza, ora, stato, posizione) anziché i punti GPS grezzi.

Sicurezza e consenso

Non memorizzare mai le credenziali nei prompt. Le chiamate a invia_comando_gprs oppure qualsiasi endpoint di cancellazione richiede la conferma esplicita dell'utente. I dati di localizzazione sono dati personali ai sensi del GDPR: non divulgarli a terzi.