Switly IoT API Documentation

Dokumentasi lengkap untuk integrasi Website dan Perangkat IoT.

Base URL: https://switly.nusabaktiteknologi.id/api

A. Endpoint Manajemen (Dashboard)

Method
Endpoint Path
Deskripsi
GET
/devicesAmbil daftar semua perangkat
POST
/devicesDaftarkan perangkat baru
GET
/devices/{chip_id}Ambil detail satu perangkat
PUT
/devices/{chip_id}Update data perangkat
DELETE
/devices/{chip_id}Hapus perangkat
GET
/devices/{chip_id}/dataAmbil riwayat data (paginasi)

B. Endpoint Komunikasi (Perangkat IoT)

Method
Endpoint Path
Deskripsi
POST
/devices/{chip_id}/heartbeatKirim sinyal heartbeat
POST
/devices/{chip_id}/dataKirim data sensor
POST
/devices/{chip_id}/pairingUpdate status pairing

Contoh Penggunaan

1. Registrasi Perangkat

POST /api/devices (Request Body) 
{
  "chip_id": "XYZ999"
}

2. Kirim Data Sensor

POST /api/devices/ABC123/data (Request Body) 
{
  "data": {
    "temperature": 27.1,
    "humidity": 55
  }
}

3. Contoh Error (422)

Response Body 
{
  "message": "The given data was invalid.",
  "errors": {
    "chip_id": [
      "The chip id field is required."
    ]
  }
}