🌍 HTTP & REST API

JSON, method, status code — cara device "berbicara" dengan cloud API.

Device → POST JSON → server → response (status + body)

📌 1. HTTP untuk IoT

HTTP adalah protokol "universal" — semua platform cloud memilikinya. Untuk IoT, HTTP dipakai lewat REST API: endpoint dengan path bermakna + data JSON.

Method	Arti	Contoh IoT
`GET`	Ambil data	`GET /api/suhu?device=sensor-01`
`POST`	Kirim data baru	`POST /api/data` dengan body JSON
`PUT`	Ganti data	`PUT /api/lampu/1` → {"nyala": true}
`DELETE`	Hapus data	`DELETE /api/device/sensor-09`

Status Code	Arti
`200`	OK — sukses
`201`	Created — data baru tersimpan
`400`	Bad Request — format salah
`401 / 403`	Unauthenticated / Forbidden — token salah/tidak berhak
`404`	Not Found — path tidak dikenal
`500`	Server Error — masalah di server

📌 2. Mengirim Data Sensor ke Cloud (POST)

Di simulator, MockServer berperan sebagai cloud API. Daftarkan handler-nya, lalu POST data JSON dari "device".

# Server cloud (mock) — di dunia nyata: AWS IoT, Firebase, Blynk, dsb.
server = register_server(MockServer("cloud-api"))

def simpan_data(body):
    # Handler menerima JSON yang dikirim device
    return {"status": "tersimpan", "device": body["device"]}

server.post("/api/data", simpan_data)

# DEVICE: kirim data tiap 10 detik
for i in range(3):
    data = {
        "device": "sensor-01",
        "suhu": read_sensor("dht22_temp"),
        "rth": read_sensor("dht22_hum"),
    }
    resp = http_post("/api/data", data, server=server)
    print("POST /api/data → HTTP %d  %s" % (resp.status, resp.json()))
    delay(10)

print()
print("Total request tercatat server:", len(server.requests))
print("Body request pertama:", server.requests[0]["body"])

Output:

📌 3. GET & Status Code

server = register_server(MockServer("cloud-api"))
server.get("/api/status", lambda body: {"uptime": now(), "device": "sensor-01"})
server.post("/api/data", lambda body: {"status": "ok"})

# GET: ambil status
resp = http_get("/api/status", server=server)
print("GET  /api/status   →", resp.status, resp.json())

# POST: kirim data
resp = http_post("/api/data", {"suhu": 27.5}, server=server)
print("POST /api/data     →", resp.status, resp.json())

# Path tidak terdaftar → 404
resp = http_get("/api/tidak-ada", server=server)
print("GET  /api/tidak-ada →", resp.status, resp.json())

Output:

📌 4. MQTT vs HTTP: Kapan Pakai yang Mana?

Aspek	MQTT	HTTP/REST
Model	Pub/sub via broker	Request/response langsung
Koneksi	Long-lived (1 koneksi, banyak pesan)	Short-lived (per request)
Overhead	Sangat kecil (header 2 byte)	Lebih besar (header per request)
Dari cloud ke device	Mudah (cukup publish)	Sulit (device harus polling / webhook)
Use case	Telemetri kontinu, kontrol real-time	Sinkron sesekali, integrasi sistem, OTA

💡 Praktiknya sering kombinasi: MQTT untuk aliran data real-time, HTTP untuk setup, konfigurasi, dan integrasi dengan sistem lain.

🧠 Latihan

Tambah endpoint GET /api/terakhir yang mengembalikan data sensor terakhir yang di-POST (simpan di variabel luar handler).
Buat handler POST /api/data yang mengembalikan 400 (pakai Response(400, {...})) jika body tidak punya kunci "device". Uji dengan dan tanpa kunci.
Buat endpoint PUT /api/lampu/1 yang menyimpan state nyala/mati, lalu GET /api/lampu/1 untuk membacanya. Simulasikan 3 perintah dari "aplikasi HP".
Jelaskan: kenapa untuk 1000 sensor yang mengirim tiap 5 detik, MQTT lebih hemat daripada HTTP? (Petunjuk: jumlah koneksi & header.)