entopizo API-referentie
GPS-tracking voor voertuigen & wagenparken

Inleiding

De entopizo API is een conventionele REST API. Elk verzoek (behalve login) wordt geauthenticeerd met een user_api_hash-token dat als parameter wordt doorgegeven. Er zijn geen SDK's te installeren — elke HTTP-client werkt.

Snelstart: uw 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 "https://go.entopizo.gr/api/get_devices?user_api_hash=HASH&lang=en"

Authenticatie

Authenticatie gebruikt een statisch per-gebruiker token, de user_api_hash. Het wordt eenmalig uitgegeven via login en vervolgens als parameter doorgegeven bij elke aanroep. Bearer-headers worden niet gebruikt. Het token verloopt niet, tenzij het accountwachtwoord wordt gewijzigd.

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

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

Conventies

Formaten die consistent worden gebruikt in de API:

Afstands- en inhoudseenheden (km/mi, liter/gallon) volgen de accountinstellingen — zie Account & Setup.

Apparaten

Een apparaat is een GPS-tracker die is geïnstalleerd in een voertuig of object. Apparaatobjecten bevatten de laatst bekende positie, bewegingsstatus en sensorwaarden, dus voor vragen als "waar bevindt mijn vloot zich nu" is één aanroep voldoende.

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

Overige apparaat-endpoints

Alle accepteren user_api_hash.

Routegeschiedenis

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

Andere geschiedenis-eindpunten

Gebeurtenissen

Gebeurtenissen zijn voorvallen die worden geregistreerd voor een apparaat: snelheidsovertreding, geofence in-/uitgang, stroomonderbreking, wegslepen, SOS en meer. Gebeurtenissen worden alleen gegenereerd wanneer een overeenkomende 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
  }
}

Andere gebeurtenis-eindpunten

Waarschuwingsregels

Waarschuwingsregels bepalen wanneer gebeurtenissen worden gegenereerd en hoe de gebruiker wordt genotificeerd (push, e-mail, 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 }

Andere alert-endpoints

Geofences & routes

Geofences zijn benoemde gebieden (veelhoeken of cirkels) die worden gebruikt voor waarschuwingen bij binnenkomst/vertrek en rapportage. Routes zijn vooraf gedefinieerde paden 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 }

Andere geofence- en route-eindpunten

Opdrachten

Opdrachten zijn berichten die naar de tracker worden verzonden via GPRS of SMS — bijvoorbeeld het stoppen/hervatten van de motor bij ondersteunde installaties. Beschikbare opdrachttypes zijn afhankelijk van het apparaatprotocol.

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

Overige commando-eindpunten

Rapporten

Genereert rapporten — algemeen, ritten & stops, rijgedrag, brandstof, snelheidsovertredingen, geofence-activiteit en meer — in HTML, PDF of XLS, of plant deze in voor automatische levering.

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

Andere rapport-endpoints

Chauffeurs

Chauffeurs kunnen handmatig aan apparaten worden toegewezen of automatisch worden geïdentificeerd via RFID / iButton. De identiteit van de chauffeur verschijnt vervolgens in de geschiedenis, gebeurtenissen en rapporten.

Sensoren

Sensoren vertalen ruwe protocolparameters naar leesbare waarden: contact, brandstofniveau, temperatuur, deurstatus, batterijspanning en meer. Sensorwaarden verschijnen binnen get_devices-antwoorden.

Onderhoud

Onderhoudsitems (services) volgen terugkerende voertuigverplichtingen — onderhoud, olieverversingen, voertuiginspectie, verzekering — op basis van kilometerstand, motoruren of kalenderdagen, met waarschuwingen bij het verstrijken van de vervaldatum.

Taken

Taken vertegenwoordigen opdrachten of leveringen die aan een voertuig zijn toegewezen, met details over ophalen/afleveren, prioriteit en statusbewaking.

Account & Instellingen

Delen, media, belacties & geocoding

Delen — links naar live-positie

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

Media — trackers met camera

Belacties — spraakoproepwaarschuwingen

Ondersteunt de entopizo instant call-functie: zet geselecteerde gebeurtenissen om in geautomatiseerde telefoonoproepmeldingen in plaats van (of naast) push/e-mail.

Geocoding

Kaarticonen & POI's

Fouten & limieten

Succesvolle aanroepen retourneren HTTP 200 met "status": 1. Bij fouten wordt "status": 0 in de body geretourneerd, of een HTTP-foutcode.

Voorbeeld van een fout

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

Richtlijnen voor AI-agents

Dit gedeelte richt zich tot LLM-gebaseerde agents (Claude, ChatGPT, aangepaste assistenten) die de API gebruiken via MCP-servers of function calling.

Aanbevolen stroom

1. Roep get_devices eenmaal aan om voertuignamen toe te wijzen aan device_id. 2. Gebruik device_id voor geschiedenis, gebeurtenissen, sensoren of opdrachten. 3. Voor vragen over de huidige positie volstaan de gegevens van get_devices — geen tweede aanroep nodig.

Token-efficiëntie

Antwoorden van get_devices en get_history zijn groot. Behoud alleen de velden id, name, online, time, speed, lat, lng, address, en in de geschiedenis de aggregaten per segment (distance, time, status, location) in plaats van ruwe GPS-punten.

Veiligheid & toestemming

Sla nooit inloggegevens op in prompts. Aanroepen naar send_gprs_command of enig destroy-endpoint vereisen expliciete bevestiging van de gebruiker. Locatiegegevens zijn persoonsgegevens onder de AVG — stel ze niet bloot aan derden.