entopizo
GPS-tracking voor voertuigen en wagenparken

Inleiding

De entopizo is een standaard REST-API. Elk verzoek (behalve inloggen) wordt geauthenticeerd met een user_api_hash token dat als parameter wordt doorgegeven. Er hoeven geen SDK’s te worden geïnstalleerd — elke HTTP-client is geschikt.

Snelstart: je eerste verzoek in 60 seconden

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"

Authenticatie

Bij de authenticatie wordt gebruikgemaakt van een statisch token per gebruiker, het user_api_hash. Deze wordt eenmalig gegenereerd bij het inloggen en vervolgens als parameter doorgegeven aan elke oproep. Er worden geen ‘Bearer’-headers gebruikt. Het token verloopt niet, tenzij het wachtwoord van het account wordt gewijzigd.

curl -X POST "entopizo" \
  -d "email=user@example.com" \
  -d "password=••••••••"

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

Conventies

Formaten die in de hele API consistent worden gebruikt:

Afstands- en inhoudseenheden (km/mi, liter/gallon) worden bepaald door de accountinstellingen — zie Account en instellingen.

Apparaten

Een apparaat is een GPS tracker in een voertuig of een ander object GPS tracker . Apparaatobjecten bevatten de laatst bekende positie, bewegingsstatus en sensorwaarden, dus voor vragen als „waar bevindt mijn wagenpark zich op dit moment?“ volstaat één enkele aanroep.

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" }
        ]
      }
    ]
  }
]

Andere apparaat-eindpunten

Alle accepteren user_api_hash.

Routegeschiedenis

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"
    }
  ]
}

Andere historische eindpunten

Evenementen

Gebeurtenissen zijn voorvallen die bij een apparaat worden geregistreerd: te hoge snelheid, het betreden of verlaten van een geofence, stroomuitval, wegslepen, SOS en meer. Gebeurtenissen worden alleen gegenereerd wanneer er een bijbehorende waarschuwingsregel actief is.

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

Overige eindpunten van het evenement

Waarschuwingsregels

Waarschuwingsregels bepalen wanneer er gebeurtenissen worden gegenereerd en hoe de gebruiker hiervan op de hoogte wordt gesteld (pushmelding, 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 }

Andere eindpunten voor waarschuwingen

Geofences en routes

Geofences zijn benoemde gebieden (veelhoeken of cirkels) die worden gebruikt voor waarschuwingen bij het binnenrijden of verlaten van een gebied en voor rapportage. Routes zijn vooraf gedefinieerde trajecten die een voertuig geacht wordt te volgen.

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 }

Overige geofence- en route-eindpunten

Commando's

Commando’s zijn berichten die via GPRS of SMS naar de tracker worden verzonden — bijvoorbeeld het stoppen of hervatten van de motor bij ondersteunde installaties. Welke soorten commando’s beschikbaar zijn, hangt af van het protocol van het apparaat.

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" }

Andere command-eindpunten

Verslagen

Genereert rapporten — algemeen, ritten en stops, rijgedrag, brandstofverbruik, snelheidsovertredingen, activiteiten binnen geofences en meer — in HTML, PDF of XLS, of plant de automatische verzending ervan in.

curl -X POST "entopizo" \
  -d "user_api_hash=HASH" \
  -d "title=Rijafstand juni" \
  -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/…"
}

Overige eindpunten van het rapport

Bestuurders

Bestuurders kunnen handmatig aan apparaten worden toegewezen of automatisch worden geïdentificeerd via RFID / iButton. De identiteit van de bestuurder wordt vervolgens weergegeven in de geschiedenis, gebeurtenissen en rapporten.

Sensoren

Sensoren zetten ruwe protocolparameters om in leesbare waarden: ontsteking, brandstofpeil, temperatuur, deurstatus, accuspanning en meer. De sensorwaarden worden weergegeven in get_devices reacties.

Onderhoud

Onderhoudsposten (diensten) houden terugkerende verplichtingen met betrekking tot het voertuig bij — onderhoudsbeurten, olieverversingen, APK, verzekering — op basis van de kilometerstand, het aantal motoruren of kalenderdagen, met waarschuwingen bij het verstrijken van de termijn.

Taken

Opdrachten zijn taken of leveringen die aan een voertuig zijn toegewezen, inclusief gegevens over het ophalen en afleveren, de prioriteit en het bijhouden van de status.

Account en instellingen

Delen, media, oproepacties en geocodering

Delen — links naar live-posities

Tijdelijke openbare links om de actuele positie van een voertuig met derden te delen (bijvoorbeeld een klant die op de levering wacht).

Media — trackers met camera

Oproepacties — meldingen bij spraakoproepen

Zorgt ervoor dat de entopizo call’-functie werkt: zet geselecteerde gebeurtenissen om in automatische telefonische meldingen in plaats van (of naast) pushmeldingen of e-mails.

Geocodering

Kaartpictogrammen en POI’s

Fouten en beperkingen

Succesvolle oproepen retourneren HTTP 200 met "status": 1. Foutmeldingen worden weergegeven "status": 0 in de tekst, of een HTTP-foutcode.

Voorbeeld van een foutmelding

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

Richtlijnen voor AI-agenten

In dit hoofdstuk wordt ingegaan op op LLM’s gebaseerde agents (Claude, ChatGPT, aangepaste assistenten) die de API gebruiken via MCP-servers of via functieaanroepen.

Aanbevolen doorstroming

1. Bellen get_devices eenmalig om voertuignamen te koppelen aan device_id. 2. Gebruik de device_id voor geschiedenis, gebeurtenissen, sensoren of opdrachten. 3. Voor vragen over de huidige positie, get_devices de gegevens zijn voldoende — een tweede telefoontje is niet nodig.

Token-efficiëntie

Reacties van get_devices en get_history zijn groot. Bewaar alleen de velden id, naam, online, tijd, snelheid, breedtegraad, lengtegraad, adres, en in de geschiedenis de geaggregeerde cijfers per segment (afstand, tijd, status, locatie) in plaats van ruwe GPS-coördinaten.

Veiligheid en toestemming

Sla inloggegevens nooit op in invoerprompts. Oproepen naar send_gprs_command of elk ‘destroy’-eindpunt vereist expliciete bevestiging door de gebruiker. Locatiegegevens zijn persoonsgegevens in de zin van de AVG — deel deze niet met derden.