Référence API entopizo
Suivi GPS pour véhicules & flottes

Introduction

L'API entopizo est une API REST conventionnelle. Chaque requête (sauf login) est authentifiée avec un jeton user_api_hash transmis en paramètre. Aucun SDK à installer — n'importe quel client HTTP fonctionne.

Démarrage rapide : votre première requête en 60 secondes

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"

Authentification

L'authentification utilise un jeton statique propre à chaque utilisateur, le user_api_hash. Il est délivré une seule fois lors de la connexion, puis transmis en paramètre à chaque appel. Les en-têtes Bearer ne sont pas utilisés. Le jeton n'expire pas, sauf si le mot de passe du compte est modifié.

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

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

Conventions

Formats utilisés de manière cohérente dans l'API :

Les unités de distance et de capacité (km/mi, litres/gallons) suivent les paramètres du compte — voir Compte et configuration.

Appareils

Un appareil est un traceur GPS installé dans un véhicule ou un actif. Les objets appareil contiennent la dernière position connue, l'état de mouvement et les valeurs des capteurs, de sorte que pour les questions du type « où se trouve ma flotte actuellement », un seul appel suffit.

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

Autres points de terminaison d'appareils

Tous acceptent user_api_hash.

Historique des trajets

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

Autres points de terminaison d'historique

Événements

Les événements sont des occurrences enregistrées pour un appareil : excès de vitesse, entrée/sortie de géorepérage, coupure d'alimentation, remorquage, SOS et plus encore. Les événements ne sont générés que lorsqu'une règle d'alerte correspondante est active.

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

Autres points de terminaison d'événements

Règles d'alerte

Les règles d'alerte définissent quand les événements sont générés et comment l'utilisateur est notifié (push, email, 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 }

Autres points de terminaison d'alerte

Géoclôtures et itinéraires

Les géoclôtures sont des zones nommées (polygones ou cercles) utilisées pour les alertes d'entrée/sortie et les rapports. Les itinéraires sont des trajets prédéfinis qu'un véhicule est censé suivre.

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 }

Autres points de terminaison pour les géoclôtures et les itinéraires

Commandes

Les commandes sont des messages envoyés au traceur via GPRS ou SMS — par exemple l'arrêt/la reprise du moteur sur les installations compatibles. Les types de commandes disponibles dépendent du protocole de l'appareil.

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

Autres points de terminaison de commande

Rapports

Génère des rapports — généraux, trajets et arrêts, comportement du conducteur, carburant, excès de vitesse, activité de géorepérage et plus encore — en HTML, PDF ou XLS, ou les planifie pour une livraison automatique.

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

Autres points de terminaison de rapport

Conducteurs

Les conducteurs peuvent être affectés aux appareils manuellement ou identifiés automatiquement via RFID / iButton. L'identité du conducteur apparaît ensuite dans l'historique, les événements et les rapports.

Capteurs

Les capteurs traduisent les paramètres bruts du protocole en valeurs lisibles : allumage, niveau de carburant, température, état de la porte, tension de la batterie et plus encore. Les valeurs des capteurs apparaissent dans les réponses get_devices.

Maintenance

Les éléments de maintenance (services) suivent les obligations récurrentes du véhicule — entretien, vidanges, contrôle technique, assurance — selon le kilométrage, les heures moteur ou les jours calendaires, avec des avertissements d'expiration.

Tâches

Les tâches représentent des travaux ou des livraisons assignés à un véhicule, avec des détails de ramassage/livraison, une priorité et un suivi du statut.

Compte et configuration

Partage, médias, actions d'appel et géocodage

Partage — liens de position en direct

Liens publics temporaires permettant de partager la position en temps réel d'un véhicule avec des tiers (par exemple, un client en attente d'une livraison).

Médias — trackers équipés d'une caméra

Actions d'appel — alertes par appel vocal

Alimente la fonctionnalité entopizo instant call : transforme les événements sélectionnés en notifications automatisées par appel téléphonique, à la place (ou en complément) des notifications push/email.

Géocodage

Icônes de carte et POI

Erreurs et limites

Les appels réussis renvoient HTTP 200 avec "status": 1. Les échecs renvoient "status": 0 dans le corps, ou un code d'erreur HTTP.

Exemple d'erreur

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

Conseils pour les agents IA

Cette section s'adresse aux agents basés sur les LLM (Claude, ChatGPT, assistants personnalisés) qui consomment l'API via des serveurs MCP ou l'appel de fonctions.

Flux recommandé

1. Appelez get_devices une fois pour associer les noms de véhicules à device_id. 2. Utilisez le device_id pour l'historique, les événements, les capteurs ou les commandes. 3. Pour les questions de position actuelle, les données get_devices sont suffisantes — aucun second appel n'est nécessaire.

Efficacité des tokens

Les réponses de get_devices et get_history sont volumineuses. Ne conservez que les champs id, name, online, time, speed, lat, lng, address, et dans l'historique les agrégats par segment (distance, time, status, location) plutôt que les points GPS bruts.

Sécurité et consentement

Ne stockez jamais d'identifiants dans les prompts. Les appels à send_gprs_command ou à tout point de terminaison de suppression nécessitent une confirmation explicite de l'utilisateur. Les données de localisation sont des données personnelles au titre du RGPD — ne les exposez pas à des tiers.