Référence entopizo
Suivi GPS pour véhicules et flottes

Introduction

entopizo est une API REST classique. Chaque requête (à l'exception de connexion) est authentifié à l'aide d'un user_api_hash jeton transmis en paramètre. Il n'y a pas de SDK à installer : n'importe quel client HTTP fait l'affaire.

Guide de 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 "entopizo"

Authentification

L'authentification utilise un jeton statique propre à chaque utilisateur, le user_api_hash. Il est généré une seule fois lors de la connexion, puis transmis en tant que paramètre à chaque appel. Les en-têtes « Bearer » ne sont pas utilisés. Le jeton reste valable tant que le mot de passe du compte n'est pas modifié.

curl -X POST "entopizo" \
  -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'ensemble de l'API :

Les unités de distance et de capacité (km/mi, litres/gallons) dépendent des paramètres de votre compte — voir « Compte et paramètres ».

Appareils

Un dispositif est un GPS tracker dans un véhicule ou sur un bien. Les objets « dispositif » contiennent la dernière position connue, l'état de mouvement et les valeurs des capteurs ; ainsi, pour répondre à des questions du type « Où se trouve ma flotte en ce moment ? », un seul appel suffit.

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

Autres points d'extrémité des appareils

Tous acceptent user_api_hash.

Historique des itinéraires

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

Autres événements historiques

Événements

Les événements sont des occurrences enregistrées sur un appareil : excès de vitesse, entrée/sortie d'une zone de géorepérage, coupure de courant, remorquage, SOS, etc. 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énement

Règles d'alerte

Les règles d'alerte définissent quand des événements sont générés et comment l'utilisateur en est informé (notification push, e-mail, SMS).

curl -X POST "entopizo" \
  -d "user_api_hash=HASH" \
  -d "name=Excès de vitesse 100 km/h" \
  -d "type=overspeed" \
  -d "overspeed=100" \
  -d "devices[]=1042" \
  -d "devices[]=1043"

{ "status": 1 }

Autres points de terminaison d'alerte

Zones géographiques et itinéraires

Les « geofences » sont des zones délimitées (polygones ou cercles) utilisées pour les alertes d'entrée/de sortie et la génération de rapports. Les itinéraires sont des parcours 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 contrôle de géorepérage et d'itinéraire

Commandes

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

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

Autres points de terminaison de commande

Rapports

Génère des rapports — généraux, sur les trajets et les arrêts, le comportement des conducteurs, la consommation de carburant, les excès de vitesse, l'activité dans les zones géolocalisées, etc. — au format HTML, PDF ou XLS, ou programme leur envoi automatique.

curl -X POST "entopizo" \
  -d "user_api_hash=HASH" \
  -d "title=Kilométrage de juin" \
  -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 critères d'évaluation du rapport

Conducteurs

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

Capteurs

Les capteurs convertissent les paramètres bruts du protocole en valeurs lisibles : allumage, niveau de carburant, température, état des portes, tension de la batterie, etc. Les valeurs des capteurs s'affichent à l'intérieur get_devices réponses.

Entretien

Les éléments d'entretien (services) permettent de suivre les obligations récurrentes liées aux véhicules — révisions, vidanges, contrôle technique, assurance — en fonction du kilométrage, des heures de fonctionnement du moteur ou des jours calendaires, avec des alertes d'échéance.

Tâches

Les missions correspondent à des tâches ou à des livraisons attribuées à un véhicule ; elles comprennent les détails relatifs à l'enlèvement et à la livraison, ainsi que le suivi de la priorité et du statut.

Compte et configuration

Partage, médias, appels à l'action et géocodage

Partage — liens vers la position en temps réel

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 — traceurs équipés d'une caméra

Actions d'appel — alertes d'appel vocal

Permet d'utiliser la fonctionnalité d'appelentopizo » : transforme les événements sélectionnés en notifications par appel téléphonique automatisé à la place (ou en plus) des notifications push ou par e-mail.

Géocodage

Icônes de carte et points d'intérêt

Erreurs et limites

Les appels réussis renvoient un code HTTP 200 avec « status » : 1. Retour des échecs « status » : 0 dans le corps du message, ou un code d'erreur HTTP.

Exemple d'erreur

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

Recommandations pour les agents d'IA

Cette section traite des agents basés sur des modèles de langage de grande envergure (LLM) (Claude, ChatGPT, assistants personnalisés) qui utilisent l'API via des serveurs MCP ou par l'appel de fonctions.

Débit recommandé

1. Appeler 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 relatives à la position actuelle, get_devices Les données sont suffisantes — aucun deuxième appel n'est nécessaire.

Efficacité des jetons

Réponses de get_devices et get_history sont volumineux. Ne conservez que les champs identifiant, nom, en ligne, heure, vitesse, latitude, longitude, adresse, et, d'un point de vue historique, les agrégats par segment (distance, heure, statut, lieu) plutôt que des coordonnées GPS brutes.

Sécurité et consentement

Ne stockez jamais d'identifiants dans les invites. Les appels vers envoyer_commande_gprs ou toute opération de suppression nécessite la confirmation explicite de l'utilisateur. Les données de localisation constituent des données à caractère personnel au sens du RGPD — ne les communiquez pas à des tiers.