Οδηγός Αναφοράς entopizo API
GPS tracking για οχήματα & στόλους

Εισαγωγή

Το API της entopizo είναι ένα συμβατικό REST API. Κάθε αίτημα (εκτός από το login) πιστοποιείται με ένα token user_api_hash που περνά ως παράμετρος. Δεν υπάρχουν SDK για εγκατάσταση — λειτουργεί οποιοσδήποτε HTTP client.

Γρήγορη Εκκίνηση: το πρώτο σου αίτημα σε 60 δευτερόλεπτα

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"

Πιστοποίηση

Η πιστοποίηση χρησιμοποιεί ένα στατικό token ανά χρήστη, το user_api_hash. Εκδίδεται μία φορά μέσω login και στη συνέχεια περνά ως παράμετρος σε κάθε κλήση. Δεν χρησιμοποιούνται Bearer headers. Το token δεν λήγει εκτός αν αλλάξει ο κωδικός πρόσβασης του λογαριασμού.

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

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

Συμβάσεις

Μορφές που χρησιμοποιούνται με συνέπεια σε όλο το API:

Οι μονάδες απόστασης και χωρητικότητας (km/mi, λίτρα/γαλόνια) ακολουθούν τις ρυθμίσεις του λογαριασμού σου — δες Λογαριασμός & Ρύθμιση.

Συσκευές

Μια συσκευή είναι ένας δέκτης GPS εγκατεστημένος σε ένα όχημα ή περιουσιακό στοιχείο. Τα αντικείμενα συσκευών φέρουν την τελευταία γνωστή θέση, την κατάσταση κίνησης και τις τιμές αισθητήρων, οπότε για ερωτήματα τύπου «πού βρίσκεται ο στόλος μου αυτή τη στιγμή» αρκεί μία μόνο κλήση.

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

Άλλα endpoints συσκευών

Όλα δέχονται user_api_hash.

Ιστορικό Διαδρομής

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

Άλλα endpoints ιστορικού

Συμβάντα

Τα συμβάντα είναι περιστατικά που καταγράφονται για μια συσκευή: υπερβολική ταχύτητα, είσοδος/έξοδος από γεωφράχτη, διακοπή ρεύματος, ρυμούλκηση, SOS και άλλα. Τα συμβάντα δημιουργούνται μόνο όταν είναι ενεργός ένας αντίστοιχος κανόνας ειδοποίησης.

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

Άλλα endpoints συμβάντων

Κανόνες Ειδοποιήσεων

Οι κανόνες ειδοποιήσεων ορίζουν πότε δημιουργούνται συμβάντα και πώς ειδοποιείται ο χρήστης (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 }

Άλλα endpoints ειδοποιήσεων

Γεωπεριφράξεις & Διαδρομές

Οι γεωπεριφράξεις είναι ονομασμένες περιοχές (πολύγωνα ή κύκλοι) που χρησιμοποιούνται για ειδοποιήσεις εισόδου/εξόδου και αναφορές. Οι διαδρομές είναι προκαθορισμένες πορείες που αναμένεται να ακολουθήσει ένα όχημα.

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 }

Άλλα endpoints γεωπεριφράξεων & διαδρομών

Εντολές

Οι εντολές είναι μηνύματα που αποστέλλονται στη συσκευή εντοπισμού μέσω GPRS ή SMS — για παράδειγμα, διακοπή/επανεκκίνηση κινητήρα σε υποστηριζόμενες εγκαταστάσεις. Οι διαθέσιμοι τύποι εντολών εξαρτώνται από το πρωτόκολλο της συσκευής.

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

Άλλα endpoints εντολών

Αναφορές

Δημιουργεί αναφορές — γενικές, διαδρομές & στάσεις, συμπεριφορά οδηγού, καύσιμο, υπερβολική ταχύτητα, δραστηριότητα γεωφράχτη και άλλα — σε HTML, PDF ή XLS, ή τις προγραμματίζει για αυτόματη παράδοση.

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

Άλλα endpoints αναφορών

Οδηγοί

Οι οδηγοί μπορούν να ανατεθούν σε συσκευές χειροκίνητα ή να αναγνωριστούν αυτόματα μέσω RFID / iButton. Η ταυτότητα του οδηγού εμφανίζεται στη συνέχεια στο ιστορικό, τα συμβάντα και τις αναφορές.

Αισθητήρες

Οι αισθητήρες μετατρέπουν τις ακατέργαστες παραμέτρους πρωτοκόλλου σε αναγνώσιμες τιμές: ανάφλεξη, στάθμη καυσίμου, θερμοκρασία, κατάσταση πόρτας, τάση μπαταρίας και άλλα. Οι τιμές αισθητήρων εμφανίζονται μέσα στις αποκρίσεις get_devices.

Συντήρηση

Τα στοιχεία συντήρησης (υπηρεσίες) παρακολουθούν επαναλαμβανόμενες υποχρεώσεις οχήματος — service, αλλαγές λαδιών, τεχνικό έλεγχο, ασφάλιση — βάσει χιλιομέτρων, ωρών λειτουργίας κινητήρα ή ημερολογιακών ημερών, με προειδοποιήσεις λήξης.

Εργασίες

Οι εργασίες αντιπροσωπεύουν δουλειές ή παραδόσεις που ανατίθενται σε ένα όχημα, με λεπτομέρειες παραλαβής/παράδοσης, προτεραιότητα και παρακολούθηση κατάστασης.

Λογαριασμός & Ρύθμιση

Κοινή χρήση, πολυμέσα, ενέργειες κλήσης & γεωκωδικοποίηση

Κοινή χρήση — σύνδεσμοι ζωντανής θέσης

Προσωρινοί δημόσιοι σύνδεσμοι για την κοινή χρήση της ζωντανής θέσης ενός οχήματος με τρίτους (π.χ. έναν πελάτη που περιμένει παράδοση).

Πολυμέσα — trackers εξοπλισμένοι με κάμερα

Ενέργειες κλήσης — ειδοποιήσεις φωνητικής κλήσης

Τροφοδοτεί τη λειτουργία entopizo instant call: μετατρέπει επιλεγμένα συμβάντα σε αυτοματοποιημένες ειδοποιήσεις τηλεφωνικής κλήσης αντί (ή παράλληλα) με push/email.

Γεωκωδικοποίηση

Εικονίδια χάρτη & POIs

Σφάλματα & όρια

Οι επιτυχείς κλήσεις επιστρέφουν HTTP 200 με "status": 1. Οι αποτυχίες επιστρέφουν "status": 0 στο σώμα, ή έναν κωδικό σφάλματος HTTP.

Παράδειγμα σφάλματος

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

Οδηγίες για πράκτορες AI

Αυτή η ενότητα απευθύνεται σε πράκτορες βασισμένους σε LLM (Claude, ChatGPT, προσαρμοσμένους βοηθούς) που χρησιμοποιούν το API μέσω MCP servers ή function calling.

Προτεινόμενη ροή

1. Κάλεσε το get_devices μία φορά για να αντιστοιχίσεις τα ονόματα οχημάτων με device_id. 2. Χρησιμοποίησε το device_id για ιστορικό, συμβάντα, αισθητήρες ή εντολές. 3. Για ερωτήματα τρέχουσας θέσης, τα δεδομένα get_devices είναι επαρκή — δεν χρειάζεται δεύτερη κλήση.

Αποδοτικότητα tokens

Οι αποκρίσεις από get_devices και get_history είναι μεγάλες. Κράτα μόνο τα πεδία id, name, online, time, speed, lat, lng, address, και στο ιστορικό τα συγκεντρωτικά στοιχεία ανά τμήμα (distance, time, status, location) αντί για ακατέργαστα σημεία GPS.

Ασφάλεια & συγκατάθεση

Ποτέ μην αποθηκεύεις διαπιστευτήρια σε prompts. Οι κλήσεις προς send_gprs_command ή οποιοδήποτε endpoint διαγραφής απαιτούν ρητή επιβεβαίωση από τον χρήστη. Τα δεδομένα τοποθεσίας είναι προσωπικά δεδομένα σύμφωνα με τον GDPR — μην τα εκθέτεις σε τρίτους.