entopizo API-Referenz
GPS-Tracking für Fahrzeuge & Flotten

Einführung

Die entopizo-API ist eine konventionelle REST-API. Jede Anfrage (außer login) wird mit einem als Parameter übergebenen user_api_hash-Token authentifiziert. Es müssen keine SDKs installiert werden — jeder HTTP-Client funktioniert.

Schnellstart: Ihre erste Anfrage in 60 Sekunden

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"

Authentifizierung

Die Authentifizierung verwendet ein statisches, benutzerspezifisches Token, das user_api_hash. Es wird einmalig über den Login ausgegeben und dann bei jedem Aufruf als Parameter übergeben. Bearer-Header werden nicht verwendet. Das Token läuft nicht ab, sofern sich das Kontopasswort nicht ändert.

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

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

Konventionen

In der gesamten API einheitlich verwendete Formate:

Entfernungs- und Kapazitätseinheiten (km/mi, Liter/Gallonen) folgen den Kontoeinstellungen — siehe Konto & Einrichtung.

Geräte

Ein Gerät ist ein GPS-Tracker, der in einem Fahrzeug oder Vermögenswert installiert ist. Geräteobjekte enthalten die zuletzt bekannte Position, den Bewegungszustand und die Sensorwerte, sodass für Fragen wie „Wo befindet sich meine Flotte gerade?“ ein einziger Aufruf ausreicht.

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

Weitere Geräte-Endpunkte

Alle akzeptieren user_api_hash.

Routenverlauf

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

Weitere Verlaufs-Endpunkte

Ereignisse

Ereignisse sind Vorkommnisse, die für ein Gerät aufgezeichnet werden: Geschwindigkeitsüberschreitung, Geofence-Ein-/Ausfahrt, Stromausfall, Abschleppen, SOS und mehr. Ereignisse werden nur generiert, wenn eine passende Alarmregel aktiv ist.

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

Weitere Ereignis-Endpunkte

Alarmregeln

Alarmregeln legen fest, wann Ereignisse generiert werden und wie der Benutzer benachrichtigt wird (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-Endpunkte

Geofences & Routen

Geofences sind benannte Bereiche (Polygone oder Kreise), die für Ein-/Ausfahrt-Alarme und Berichte verwendet werden. Routen sind vordefinierte Strecken, denen ein Fahrzeug voraussichtlich folgen soll.

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 }

Weitere Geofence- und Routen-Endpunkte

Befehle

Befehle sind Nachrichten, die über GPRS oder SMS an den Tracker gesendet werden – zum Beispiel Motor stoppen/fortsetzen bei unterstützten Installationen. Die verfügbaren Befehlstypen hängen vom Geräteprotokoll ab.

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

Andere Befehls-Endpunkte

Berichte

Erstellt Berichte — allgemein, Fahrten & Stopps, Fahrerverhalten, Kraftstoff, Geschwindigkeitsüberschreitung, Geofence-Aktivität und mehr — in HTML, PDF oder XLS, oder plant sie für die automatische Zustellung.

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 Berichts-Endpunkte

Fahrer

Fahrer können Geräten manuell zugewiesen oder automatisch über RFID / iButton identifiziert werden. Die Fahreridentität erscheint anschließend in Verlauf, Ereignissen und Berichten.

Sensoren

Sensoren übersetzen rohe Protokollparameter in lesbare Werte: Zündung, Kraftstoffstand, Temperatur, Türstatus, Batteriespannung und mehr. Sensorwerte erscheinen innerhalb der get_devices-Antworten.

Wartung

Wartungselemente (Services) verfolgen wiederkehrende Fahrzeugpflichten — Wartung, Ölwechsel, Fahrzeuginspektion, Versicherung — nach Kilometerstand, Motorstunden oder Kalendertagen, mit Ablaufwarnungen.

Aufgaben

Aufgaben repräsentieren Aufträge oder Lieferungen, die einem Fahrzeug zugewiesen sind, mit Abhol-/Lieferdetails, Priorität und Statusverfolgung.

Konto & Einrichtung

Teilen, Medien, Anrufaktionen & Geokodierung

Teilen — Links zur Live-Position

Temporäre öffentliche Links, um die Live-Position eines Fahrzeugs mit Dritten zu teilen (z. B. ein Kunde, der auf eine Lieferung wartet).

Medien — Tracker mit Kamera

Call Actions — Sprachanruf-Benachrichtigungen

Treibt die Funktion entopizo instant call an: wandelt ausgewählte Ereignisse in automatisierte Telefonanruf-Benachrichtigungen um, anstelle von (oder zusätzlich zu) Push/E-Mail.

Geocoding

Kartensymbole & POIs

Fehler & Grenzwerte

Erfolgreiche Aufrufe geben HTTP 200 mit "status": 1 zurück. Fehler geben "status": 0 im Body zurück, oder einen HTTP-Fehlercode.

Fehlerbeispiel

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

Anleitung für KI-Agenten

Dieser Abschnitt richtet sich an LLM-basierte Agenten (Claude, ChatGPT, benutzerdefinierte Assistenten), die die API über MCP-Server oder Funktionsaufrufe nutzen.

Empfohlener Ablauf

1. Rufen Sie get_devices einmal auf, um Fahrzeugnamen auf device_id abzubilden. 2. Verwenden Sie device_id für Verlauf, Ereignisse, Sensoren oder Befehle. 3. Für Fragen zur aktuellen Position sind die Daten von get_devices ausreichend — kein zweiter Aufruf erforderlich.

Token-Effizienz

Die Antworten von get_devices und get_history sind umfangreich. Behalten Sie nur die Felder id, name, online, time, speed, lat, lng, address, und im Verlauf die Aggregate pro Segment (distance, time, status, location) anstelle von rohen GPS-Punkten.

Sicherheit & Zustimmung

Speichern Sie niemals Anmeldedaten in Prompts. Aufrufe von send_gprs_command oder jedem löschenden Endpunkt erfordern eine ausdrückliche Bestätigung durch den Benutzer. Standortdaten sind personenbezogene Daten gemäß DSGVO — geben Sie sie nicht an Dritte weiter.