MyGPS REST API

Γρήγορη εκκίνηση

Τρία βήματα από το μηδέν στην πρώτη επιτυχημένη κλήση.

1. Δημιουργήστε token. Στην πλατφόρμα: Ρυθμίσεις λογαριασμού → Token. Ορίστε ημερομηνία λήξης και αντιγράψτε το.
2. Καλέστε ένα endpoint με header Authorization: Bearer <token>.
3. Αντιστοιχίστε ονόματα σε IDs. Το /devices σας δίνει το id κάθε οχήματος — το χρειάζεστε παντού αλλού.

# 1. Τελευταία θέση όλων των οχημάτων
curl -H "Authorization: Bearer $TOKEN" \
  "https://app.mygps.gr/api/positions"

# 2. Σύνοψη χιλιομέτρων για δύο οχήματα, τον Ιούλιο
curl -H "Authorization: Bearer $TOKEN" \
  "https://app.mygps.gr/api/reports/summary?deviceId=42&deviceId=43\
&from=2026-07-01T00:00:00Z&to=2026-08-01T00:00:00Z"

# 3. Η ίδια αναφορά σε Excel
curl -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
  -o summary.xlsx \
  "https://app.mygps.gr/api/reports/summary?deviceId=42&from=...&to=..."

Authentication

Δύο σχήματα στο header Authorization. Χωρίς έγκυρη ταυτοποίηση επιστρέφεται 401.

Συμβάσεις

Οχήματα

Βασικά πεδία: id, name, uniqueId, status (online/offline/unknown), lastUpdate, positionId, groupId, disabled, attributes.

Θέσεις

Πεδία: deviceId, deviceTime, fixTime, serverTime, latitude, longitude, altitude, speed, course, address, valid, attributes.

Εναλλακτικές μορφές με header Accept: KML, CSV, XLSX, GPX.

WebSocket — ζωντανή ροή

Ο σωστός τρόπος για live χάρτη ή ειδοποιήσεις. Απαιτεί ενεργή συνεδρία (cookie).

wss://app.mygps.gr/api/socket

// Μηνύματα JSON, push σε κάθε μεταβολή
{ "positions": [ … ] }   // νέα θέση
{ "devices":   [ … ] }   // αλλαγή κατάστασης οχήματος
{ "events":    [ … ] }   // συμβάν (γεωφράχτης, ταχύτητα, ανάφλεξη…)

Αναφορές

Κοινές παράμετροι: deviceId, groupId (επαναλαμβανόμενες), from, to. JSON από προεπιλογή· για Excel στείλτε Accept: …spreadsheetml.sheet.

Τύποι συμβάντων

Γεωφράχτες

// Μορφή WKT στο πεδίο area
"CIRCLE (40.5231 22.9714, 250)"
"POLYGON ((40.52 22.97, 40.53 22.98, 40.52 22.99))"

// Σύνδεση γεωφράχτη με όχημα
POST /api/permissions
{ "deviceId": 42, "geofenceId": 7 }

Ειδοποιήσεις

Οδηγοί, ομάδες, συντηρήσεις

Εντολές προς συσκευές

POST /api/commands/send
{
  "deviceId": 42,
  "type": "positionSingle"
}

// Ενδεικτικοί τύποι
custom · positionSingle · positionPeriodic · engineStop · engineResume
outputControl · rebootDevice · setOdometer · requestPhoto · getDeviceStatus

Εργασίες & δρομολόγηση

Εργασίες με στάσεις, ανάθεση σε οδηγούς, αποδεικτικά παράδοσης και δρομολόγηση.

Webhooks & integration keys

Για διασύνδεση τρίτων συστημάτων: το ERP σας δημιουργεί εργασία, η MyGPS σας ειδοποιεί σε κάθε μεταβολή.

# Το integration key πάει σε δικό του header
curl -X POST \
  -H "X-MyGPS-Dispatch-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{"job": { … }, "stops": [ … ]}' \
  "https://app.mygps.gr/api/dispatch/jobs/public-api/jobs"

Τύποι συμβάντων webhook: job.created, job.updated, job.status.changed, stop.status.changed, proof.created, customer.feedback.created, customer.notification.created, control.alert, test.

Υπόλοιπες λειτουργίες — τεκμηρίωση κατόπιν αιτήματος

Η πλατφόρμα διαθέτει API και για τις υπόλοιπες λειτουργίες της: βιβλία στόλου, διαχείριση έργων, driver scoring, βίντεο και κάμερες, ενδοεπικοινωνία PTT, καθώς και τη Ψηφιακή Διακίνηση της ΑΑΔΕ.

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

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