Ketentuan perangkat IoT dan API

Ketentuan ini berlaku untuk perangkat IoT yang terhubung ke Smart Farm dan untuk API penerimaan data perangkat. Ketentuan ini melengkapi Ketentuan layanan, Kebijakan penggunaan, dan Keamanan.

API yang tersedia untuk dipakai pihak luar saat ini hanya API perangkat untuk mengirim data sensor. Alamat API lain yang dipakai aplikasi web bersifat internal: alamat itu bisa berubah tanpa pemberitahuan dan tidak boleh dipakai untuk otomatisasi, pengambilan data massal, atau integrasi pihak ketiga tanpa izin tertulis dari kami.

1. Pemilik membuka Pengaturan > Perangkat IoT dan menambahkan perangkat dengan kode dan nama yang mudah dikenali.
2. Kaitkan perangkat ke kolam tempat sensor dipasang. Tanpa kolam, data tetap diterima dan dicatat di log perangkat, tetapi tidak masuk ke catatan kualitas air kolam.
3. Simpan kunci perangkat yang ditampilkan. Kunci hanya tampil sekali; kami menyimpannya dalam bentuk hash sehingga tidak bisa menampilkannya lagi.
4. Pasang kunci di firmware perangkat, lalu kirim data uji dan pastikan perangkat terlihat aktif di aplikasi.

Setelah ada perangkat terdaftar, menu IoT dan sensor muncul di sidebar untuk memantau status perangkat, waktu terakhir terlihat, tegangan baterai, dan kekuatan sinyal.

Kunci perangkat adalah kata sandi untuk alat Anda. Siapa pun yang memegangnya bisa mengirim data atas nama perangkat itu ke tambak Anda.

• Gunakan satu kunci untuk satu perangkat. Jangan memakai kunci yang sama di beberapa alat.
• Jangan menaruh kunci di kode yang dibagikan publik, misalnya repositori terbuka, forum, atau tangkapan layar.
• Bila kunci hilang, diduga bocor, atau perangkat dijual atau dipindahtangankan, rotasi kunci dari halaman perangkat. Kunci lama langsung tidak berlaku, dan rotasi tercatat di Log aktivitas.
• Ubah status perangkat menjadi nonaktif atau perawatan bila alat sedang dilepas atau diperbaiki. Perangkat yang tidak berstatus aktif ditolak saat mengirim data.

Anda bertanggung jawab atas data yang masuk melalui kunci perangkat Anda sampai kunci tersebut dirotasi atau perangkatnya dinonaktifkan.

Perangkat mengirim data dengan permintaan POST ke alamat /api/v1/iot/telemetry pada domain Smart Farm, melalui HTTPS. Kunci perangkat dikirim di header X-Device-Key, dan isi permintaan berupa JSON.

Nilai yang dikenali

Nilai bisa dikirim langsung di isi JSON atau di dalam objek readings. Kolom tambahan yang boleh dikirim: batteryVoltage, signalRssi, firmwareVersion, dan timestamp (waktu pengukuran dalam format ISO 8601). Tanpa timestamp, waktu penerimaan di server yang dipakai.

Penyaringan data

Nilai yang bukan angka atau berada di luar rentang di atas dianggap lonjakan (spike) dari sensor. Nilai itu disimpan di log mentah sebagai bahan pemeriksaan, tetapi tidak dipakai untuk penilaian kualitas air dan Smart Advisory. Nilai yang lolos dibulatkan dua angka desimal.

Tanggapan server

Server Smart Farm dipakai bersama oleh banyak tambak. Agar adil untuk semua, ikuti batas berikut:

• Kirim data paling sering sekali per menit per perangkat. Untuk kebanyakan kolam, selang 5 sampai 15 menit sudah cukup untuk memantau perubahan.
• Kirim satu set pembacaan per permintaan dengan ukuran wajar. Jangan mengirim berkas, gambar, atau data yang tidak berkaitan dengan sensor.
• Bila pengiriman gagal, coba lagi dengan jeda yang makin panjang, misalnya 1, 2, lalu 5 menit. Jangan mengulang tanpa jeda.
• Kode 401, 402, dan 403 tidak akan berubah dengan mengulang. Perbaiki penyebabnya lebih dulu.

Kami dapat menerapkan pembatasan otomatis, menolak sementara, atau menonaktifkan perangkat yang mengirim data berlebihan atau mengganggu layanan. Bila memungkinkan, kami memberi tahu pemilik tambak lebih dulu. Bila Anda membutuhkan pengiriman yang lebih sering untuk keperluan khusus, hubungi kami lebih dulu.

• Setiap kiriman dicatat di log perangkat, berisi nilai mentah dan nilai yang sudah disaring.
• Bila perangkat terkait ke kolam, data juga dicatat sebagai pemeriksaan kualitas air dengan sumber sensor IoT, dikaitkan dengan siklus aktif di kolam itu, lalu dinilai oleh Smart Advisory.
• Data sensor adalah bagian dari data tambak Anda, ikut dalam unduhan data, dan disimpan sesuai Penyimpanan dan penghapusan data.
• Kami tidak menjual data sensor Anda. Data hanya kami proses untuk menjalankan layanan sesuai Kebijakan privasi.

Smart Farm tidak menjual, memasang, atau merawat perangkat keras. Perangkat, sensor, firmware, catu daya, dan koneksi internet sepenuhnya menjadi tanggung jawab Anda atau penyedia alat Anda. Untuk itu:

• Kalibrasi dan bersihkan sensor secara berkala sesuai petunjuk pembuatnya. Sensor yang kotor atau rusak menghasilkan angka yang salah.
• Pastikan perangkat dipasang dengan aman dari air, petir, dan arus listrik bocor.
• Smart Farm hanya menerima dan menampilkan data. Smart Farm tidak mengendalikan kincir, pompa, atau alat lain di kolam.
• Jangan menjadikan sensor dan aplikasi satu-satunya pengaman kolam. Data bisa terlambat atau hilang karena listrik padam, sinyal putus, sensor rusak, atau gangguan layanan. Tetap siapkan pengecekan langsung dan peralatan cadangan.

Sejauh diizinkan hukum, kami tidak bertanggung jawab atas kerugian akibat kerusakan perangkat, data sensor yang salah, data yang tidak terkirim, atau keputusan yang diambil semata-mata berdasarkan data sensor. Lihat juga Batasan Smart Advisory dan simulasi.

• Mengirim data palsu atau rekayasa yang sengaja menyesatkan, termasuk ke tambak orang lain.
• Mencoba menebak, mencuri, atau memakai kunci perangkat milik tambak lain.
• Menguji beban, memindai celah, atau sengaja membanjiri API tanpa izin tertulis. Temuan celah keamanan dilaporkan lewat Pelaporan kerentanan.
• Memakai API untuk tujuan selain mengirim data sensor kolam milik tambak Anda.

Pelanggaran dapat membuat perangkat dinonaktifkan, kunci dicabut, dan akses akun dibatasi.

Alamat API perangkat memakai nomor versi (v1). Kami berusaha menjaga perubahan tetap kompatibel dengan perangkat yang sudah terpasang. Bila perlu perubahan yang membuat perangkat lama tidak bisa mengirim data lagi, kami mengumumkannya paling lambat 14 hari sebelumnya, kecuali perubahan mendesak untuk keamanan. Penambahan kolom baru yang tidak wajib dapat dilakukan kapan saja.

Pertanyaan teknis seputar perangkat dapat diajukan lewat Pengaturan > Pusat bantuan atau kontak di bagian bawah halaman ini.