Αναφορά entopizo
Παρακολούθηση GPS για οχήματα και στόλους

Εισαγωγή

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

Γρήγορη εκκίνηση: το πρώτο σας αίτημα σε 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 "entopizo"

Πιστοποίηση

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

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

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

Συνέδρια

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

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

Συσκευές

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

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

Άλλα τερματικά συσκευών

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

Ιστορικό διαδρομών

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

Άλλα ιστορικά σημεία αναφοράς

Εκδηλώσεις

Τα συμβάντα είναι περιστατικά που καταγράφονται σε μια συσκευή: υπέρβαση ταχύτητας, είσοδος/έξοδος από γεωφράγμα, διακοπή ρεύματος, ρυμούλκηση, 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
  }
}

Άλλα σημεία τερματισμού εκδηλώσεων

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

Οι κανόνες ειδοποιήσεων καθορίζουν πότε δημιουργούνται τα συμβάντα και με ποιον τρόπο ειδοποιείται ο χρήστης (push, email, SMS).

curl -X POST "entopizo" \
  -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 }

Άλλα σημεία τερματισμού ειδοποιήσεων

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

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

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 }

Άλλα σημεία τερματισμού γεωφράγματος και διαδρομής

Εντολές

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

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

Άλλα σημεία τερματισμού εντολών

Αναφορές

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

curl -X POST "entopizo" \
  -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/…"
}

Άλλα κριτήρια αξιολόγησης της μελέτης

Οδηγοί

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

Αισθητήρες

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

Συντήρηση

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

Καθήκοντα

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

Λογαριασμός & Ρυθμίσεις

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

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

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

Μέσα — συσκευές εντοπισμού εξοπλισμένες με κάμερα

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

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

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

Εικονίδια χάρτη & σημεία ενδιαφέροντος (POI)

Σφάλματα και περιορισμοί

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

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

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

Οδηγίες για τους πράκτορες τεχνητής νοημοσύνης

Αυτή η ενότητα αφορά τους πράκτορες που βασίζονται σε LLM (Claude, ChatGPT, εξατομικευμένοι βοηθοί) οι οποίοι χρησιμοποιούν το API μέσω διακομιστών MCP ή κλήσεων συναρτήσεων.

Συνιστώμενη ροή

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

Αποδοτικότητα των token

Απαντήσεις από get_devices και get_history είναι μεγάλα. Διατηρήστε μόνο τα πεδία id, όνομα, συνδεδεμένος, ώρα, ταχύτητα, γεωγραφικό πλάτος, γεωγραφικό μήκος, διεύθυνση, και στην ιστορία τα συγκεντρωτικά στοιχεία ανά τμήμα (απόσταση, χρόνος, κατάσταση, τοποθεσία) αντί για ακατέργαστα σημεία GPS.

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

Ποτέ μην αποθηκεύετε διαπιστευτήρια σε προτροπές. Οι κλήσεις προς αποστολή_εντολής_GPRS ή οποιοδήποτε σημείο τερματισμού που αφορά διαγραφή απαιτεί ρητή επιβεβαίωση από τον χρήστη. Τα δεδομένα τοποθεσίας αποτελούν προσωπικά δεδομένα σύμφωνα με τον ΓΚΠΔ — μην τα κοινοποιείτε σε τρίτους.