API Documentation: devices

Περιγραφή

Καταχώριση/εισαγωγή νέας συσκευής στην πλατφόρμα Globismart Smart City Platform.

Base URL & Μέθοδος

POST [base_url]/api/devices_register.php

Αναμένει Content-Type: application/json.

Body Παράμετροι (JSON)

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
key	String	Ναι	API key για εξουσιοδότηση.
device_name	String	Ναι	Ονομασία συσκευής.
device_type	String	Ναι	Τύπος συσκευής.
protocol	String	Όχι	Πρωτόκολλο επικοινωνίας.
external_id	String	Όχι	Εξωτερικό αναγνωριστικό.
location	Object	Όχι	Συντεταγμένες τοποθεσίας.
mqtt_topic	String	Όχι	MQTT topic.
metadata	Object	Όχι	Μεταδεδομένα.
created_by	Integer	Όχι	ID χρήστη.

Παράδειγμα Αίτησης

POST /api/devices_register.php
Host: [base_url]
Content-Type: application/json

{
  "key": "MY_SECRET_API_KEY",
  "device_name": "Thermostat A1",
  "device_type": "thermostat",
  "protocol": "mqtt",
  "external_id": "a1b2c3d4-e5f6-11ee-be56-0242ac120002",
  
  "location": { "lat": 40.69097, "lng": 21.67802 },
  "mqtt_topic": "schools/SCH-0032/thermostats/A1",
  "metadata": { "model": "T-200", "firmware": "1.4.2", "vendor": "Globiled" },
  "created_by": 25
}

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

{
  "status": "success",
  "device_id": 5021,
  "device_name": "Thermostat A1",
 
  "created_at": "2025-08-08 12:41:21",
  "idempotent": true
}

Πιθανά Σφάλματα

HTTP Code	Περιγραφή
400	Μη έγκυρες παράμετροι
401	Μη εξουσιοδοτημένη πρόσβαση
409	Διπλότυπη συσκευή
422	Σφάλμα επικύρωσης
500	Εσωτερικό σφάλμα

Παράδειγμα curl

curl -X POST "[base_url]/api/devices_register.php" \
  -H "Content-Type: application/json" \
  -d '{
        "key": "MY_SECRET_API_KEY",
        "device_name": "Thermostat A1",
        "device_type": "thermostat",
        "protocol": "mqtt",
        "external_id": "a1b2c3d4-e5f6-11ee-be56-0242ac120002",
        "location": { "lat": 40.69097, "lng": 21.67802 },
        "mqtt_topic": "schools/SCH-0032/thermostats/A1",
        "metadata": { "model": "T-200", "firmware": "1.4.2", "vendor": "Globiled" }
      }'