API Documentation: command

Περιγραφή

Επιστροφή της κατάστασης εκτέλεσης εντολής που έχει σταλεί σε συσκευή μέσω device_command.php. Η αναζήτηση γίνεται με βάση το correlation_id, και προαιρετικά μπορεί να γίνει έλεγχος και για συγκεκριμένο device_id/external_id.

Η κατάσταση μπορεί να είναι: pending, executed, failed, timeout.

Base URL

GET [base_url]/api/command_status.php

Query Παράμετροι

Παράμετρος	Τύπος	Υποχρεωτική	Περιγραφή
key	String	Ναι	API key για εξουσιοδότηση
correlation_id	String	Ναι	Αναγνωριστικό συσχέτισης της εντολής
device_id	Integer	Όχι	ID συσκευής (προαιρετική επικύρωση)
external_id	String	Όχι	Εξωτερικό αναγνωριστικό συσκευής (idempotent id)

Παράδειγμα Απόκρισης

{
  "correlation_id": "9e7c1c48-8b5b-4f8a-839c-1a0fd6f6f0a2",
  "device_id": 5021,
  "status": "executed",
  "requested_at": "2025-08-08T12:50:00Z",
  "executed_at": "2025-08-08T12:50:03Z",
  "result": {"ack": true, "detail": "temperature set to 22"},
  "last_error": null
}

Περιγραφή Πεδίων

Πεδίο	Τύπος	Περιγραφή
status	String	Τρέχουσα κατάσταση: `pending` \| `executed` \| `failed` \| `timeout`
requested_at	String (datetime)	Χρόνος υποβολής της εντολής
executed_at	String (datetime)	Χρόνος ολοκλήρωσης (αν υπάρχει)
result	Object	Λεπτομέρειες/απάντηση από τη συσκευή (π.χ. `ack`, μετρούμενες τιμές)
last_error	Object \| null	Τελευταίο σφάλμα (κωδικός/μήνυμα) αν υπάρχει

Κωδικοί Σφαλμάτων

HTTP Code	Περιγραφή
200	Επιτυχία
401	Μη εξουσιοδοτημένη πρόσβαση
400	Μη έγκυρες παράμετροι
404	Δεν βρέθηκε καταχώριση για το συγκεκριμένο `correlation_id`
500	Εσωτερικό σφάλμα συστήματος

Παράδειγμα curl

curl -G "[base_url]/api/command_status.php" \
  --data-urlencode "key=MY_SECRET_API_KEY" \
  --data-urlencode "correlation_id=9e7c1c48-8b5b-4f8a-839c-1a0fd6f6f0a2"