entopizo Referenz
GPS-Ortung für Fahrzeuge und Flotten

Einleitung

Die entopizo ist eine herkömmliche REST-API. Jede Anfrage (mit Ausnahme von Anmelden) wird mit einem user_api_hash Als Parameter übergegebenes Token. 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 "entopizo"

Authentifizierung

Für die Authentifizierung wird ein statisches, benutzerspezifisches Token verwendet, das user_api_hash. Er wird einmalig nach der Anmeldung generiert und anschließend als Parameter an jeder Aufruf. Es werden keine Bearer-Header verwendet. Das Token läuft erst ab, wenn das Passwort des Kontos geändert wird.

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

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

Konventionen

Formate, die in der gesamten API einheitlich verwendet werden:

Die Einheiten für Entfernungen und Fassungsvermögen (km/mi, Liter/Gallonen) richten sich nach den Kontoeinstellungen – siehe „Konto & Einstellungen“.

Geräte

Ein Gerät ist ein GPS tracker , der in einem Fahrzeug oder einem Objekt GPS tracker . Geräteobjekte enthalten die zuletzt bekannten Positionsdaten, Bewegungszustände und Sensorwerte, sodass für Fragen wie „Wo befindet sich meine Flotte gerade?“ ein einziger Abruf ausreicht.

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 Geräteendpunkte

Alle akzeptieren user_api_hash.

Streckenverlauf

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

Weitere historische Meilensteine

Veranstaltungen

Ereignisse sind Vorfälle, die für ein Gerät erfasst werden: Geschwindigkeitsüberschreitungen, Ein- und Ausfahren aus Geofences, Stromausfall, Abschleppen, SOS-Signale und mehr. Ereignisse werden nur generiert, wenn eine entsprechende 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 Ereignisendpunkte

Benachrichtigungsregeln

Alarmregeln legen fest, wann Ereignisse generiert werden und wie der Benutzer benachrichtigt wird (Push-Benachrichtigung, E-Mail, SMS).

curl -X POST "entopizo" \
  -d "user_api_hash=HASH" \
  -d "name=Geschwindigkeitsüberschreitung 100 km/h" \
  -d "type=overspeed" \
  -d "overspeed=100" \
  -d "devices[]=1042" \
  -d "devices[]=1043"

{ "status": 1 }

Weitere Endpunkte für Benachrichtigungen

Geofences & Routen

Geofences sind benannte Bereiche (Polygone oder Kreise), die für Ein- und Ausfahrtsbenachrichtigungen sowie für die Berichterstellung verwendet werden. Routen sind vordefinierte Strecken, denen ein Fahrzeug voraussichtlich folgen wird.

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 Routenendpunkte

Befehle

Befehle sind Nachrichten, die über GPRS oder SMS an den Tracker gesendet werden – beispielsweise zum Stoppen bzw. Wiederanlaufen des Motors bei unterstützten Installationen. Die verfügbaren Befehlstypen hängen vom Geräteprotokoll ab.

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

Weitere Befehlsendpunkte

Berichte

Erstellt Berichte – allgemeine Berichte, Fahrten und Stopps, Fahrverhalten, Kraftstoffverbrauch, Geschwindigkeitsüberschreitungen, Aktivitäten innerhalb von Geofences und mehr – im HTML-, PDF- oder XLS-Format oder plant deren automatische Zustellung.

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

Weitere Berichtsendpunkte

Fahrer

Fahrer können Geräten manuell zugewiesen oder automatisch über RFID/iButton identifiziert werden. Die Identität des Fahrers wird dann im Verlauf, in den Ereignissen und in den Berichten angezeigt.

Sensoren

Sensoren wandeln rohe Protokollparameter in lesbare Werte um: Zündung, Kraftstoffstand, Temperatur, Türstatus, Batteriespannung und mehr. Die Sensorwerte werden im Inneren angezeigt get_devices Antworten.

Wartung

Unter „Wartungspositionen“ (Dienstleistungen) werden wiederkehrende Fahrzeugverpflichtungen – Wartung, Ölwechsel, Hauptuntersuchung, Versicherung – anhand des Kilometerstands, der Betriebsstunden oder der Kalendertage erfasst, einschließlich Warnmeldungen bei Ablauf der Fristen.

Aufgaben

Aufträge sind einem Fahrzeug zugewiesene Aufträge oder Lieferungen, einschließlich Angaben zur Abholung/Zustellung, Priorität und Statusverfolgung.

Konto & Einrichtung

Teilen, Medien, Aufrufaktionen und Geokodierung

Teilen – Links zu Live-Positionen

Temporäre öffentliche Links, um die aktuelle Position eines Fahrzeugs mit Dritten zu teilen (z. B. mit einem Kunden, der auf die Lieferung wartet).

Medien – mit Kameras ausgestattete Tracker

Anrufaktionen – Benachrichtigungen bei Sprachanrufen

Ermöglicht die entopizo Call“-Funktion: Verwandelt ausgewählte Ereignisse in automatische Telefonanrufe anstelle von (oder zusätzlich zu) Push-Benachrichtigungen oder E-Mails.

Geokodierung

Kartensymbole und POIs

Fehler und Einschränkungen

Erfolgreiche Aufrufe geben HTTP zurück 200 mit "status": 1. Fehler werden zurückgegeben "status": 0 im Textkörper oder einen HTTP-Fehlercode.

Fehlerbeispiel

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

Leitfaden für KI-Agenten

Dieser Abschnitt befasst sich mit LLM-basierten Agenten (Claude, ChatGPT, benutzerdefinierte Assistenten), die die API über MCP-Server oder Funktionsaufrufe nutzen.

Empfohlene Durchflussmenge

1. Anruf get_devices einmal, um Fahrzeugnamen zuzuordnen device_id. 2. Verwenden Sie die device_id für Verlauf, Ereignisse, Sensoren oder Befehle. 3. Bei Fragen zur aktuellen Position, get_devices Die Daten reichen aus – ein zweiter Anruf ist nicht erforderlich.

Token-Effizienz

Antworten von get_devices und get_history sind groß. Behalten Sie nur die Felder ID, Name, online, Zeit, Geschwindigkeit, Breitengrad, Längengrad, Adresse, und in der historischen Datenreihe die Segment-Aggregate (Entfernung, Zeit, Status, Standort) anstelle von rohen GPS-Koordinaten.

Sicherheit und Einwilligung

Speichern Sie Anmeldedaten niemals in Eingabeaufforderungen. Aufrufe von send_gprs_command oder jeder „destroy“-Endpunkt erfordert eine ausdrückliche Bestätigung durch den Nutzer. Standortdaten sind personenbezogene Daten im Sinne der DSGVO – geben Sie diese nicht an Dritte weiter.