Hello, bagaimana kami bisa membantu Anda?

Authorization: Basic base64(api_key:secret_key)

• api_key berfungsi sebagai username
• secret_key berfungsi sebagai password
• Authentication bersifat stateless (tidak menggunakan session atau token)

• Gunakan HTTPS di semua request
• Jangan expose API key di frontend
• Simpan credential di environment variables

• Request berulang dalam waktu singkat dapat dibatasi
• Polling berlebihan dapat menyebabkan throttling
• Beban tinggi dari satu API key dapat memicu pembatasan sementara

• Gunakan interval request sesuai interval device (misalnya 1 jam)
• Hindari polling setiap detik
• Gunakan caching di sisi client

• Mendapatkan daftar device
• Informasi detail device

• Data sensor terbaru
• Data historis berdasarkan timestamp

https://app.mertani.co.id/external/v1

• GET /devices
• GET /devices/{id}

• Header: JSON / HTTP standard
• Authentication: Basic Auth

• Format utama: JSON
• Encoding: UTF-8
• Timestamp: ISO 8601 / Unix timestamp (tergantung endpoint)

{
  "device_id": "123",
  "timestamp": "2025-01-01T10:00:00Z",
  "temperature": 27.5
}

• Ringan dan mudah diparse
• Kompatibel dengan hampir semua bahasa pemrograman
• Ideal untuk REST API

• Umumnya interval: 1 jam sekali
• API hanya menyajikan data yang sudah tersimpan di database

• Gunakan Webhook API (push-based)
• Atau lakukan polling dengan interval yang disesuaikan

• Client tidak pernah berkomunikasi langsung dengan device
• Semua akses harus melalui API
• Data diambil dari database, bukan dari perangkat secara live

• Keamanan sistem
• Konsistensi data
• Skalabilitas

• Validasi device
• Validasi format data
• Normalisasi
• Penyimpanan ke database

• Delay dapat terjadi jika jaringan tidak stabil
• Data duplikat bisa terjadi jika device retry

• 200 → Success
• 400 → Bad request
• 401 → Unauthorized
• 403 → Forbidden
• 500 → Server error

• Implementasikan retry mechanism
• Logging error response
• Validasi request sebelum dikirim

• Membutuhkan data historis
• Membangun dashboard
• Kontrol penuh terhadap request

• Membutuhkan data real-time
• Ingin sistem event-driven
• Menghindari polling

• Perangkat belum mengirim data
• Interval pengiriman belum tercapai

• Periksa status device
• Tunggu hingga siklus pengiriman berikutnya

• Jaringan perangkat tidak stabil
• Delay pada proses ingestion

• Periksa konektivitas device
• Validasi timestamp data

• Sensor error atau tidak terkalibrasi
• Data duplikat atau missing

• Lakukan kalibrasi sensor
• Validasi data di level aplikasi

• Request tidak menggunakan parameter waktu terbaru
• Cache pada client

• Gunakan filter timestamp terbaru
• Disable cache jika diperlukan

• Endpoint tidak dapat diakses (down / timeout)
• URL webhook salah

• Periksa endpoint server Anda
• Validasi URL dan response status (200 OK)

• Polling terlalu cepat sebelum data tersedia
• Parameter waktu tidak sesuai

• Sesuaikan interval polling dengan device
• Gunakan filter timestamp terbaru

• Retry dari server karena response gagal
• Tidak ada deduplication di client

• Implementasikan idempotency di sisi client
• Simpan unique identifier data

• Volume data tinggi
• Endpoint tidak scalable

• Gunakan queue system (Kafka, RabbitMQ, dll)
• Tambahkan rate limiting atau buffering

• Header Authorization tidak ada
• Format Basic Authentication salah
• Base64 encoding tidak valid

• API key tidak memiliki akses ke resource
• API key telah dicabut

• API key tidak memiliki akses ke data tertentu
• Parameter request tidak sesuai

• API key tersimpan di frontend
• Repository tidak diamankan

• Email salah atau tidak aktif
• Email masuk ke folder spam

• Periksa kembali alamat email
• Minta pengguna cek folder spam atau promotion
• Kirim ulang undangan jika tersedia

• Proses aktivasi belum selesai
• Password belum diterima melalui email

• Pastikan pengguna telah membuka link undangan
• Minta pengguna terima undangan

• Invite belum diproses sepenuhnya
• Halaman belum diperbarui

• Refresh halaman
• Periksa kembali status undangan

• Salah memilih role saat invite
• Perubahan belum tersimpan

• Gunakan fitur Assign Role untuk memperbaiki
• Pastikan konfigurasi role benar saat invite

• Form belum diisi dengan benar
• Validasi sistem gagal

• Pastikan semua field wajib sudah diisi
• Periksa kembali format data

• Cache browser belum diperbarui
• Gangguan sinkronisasi

• Refresh halaman
• Coba login ulang jika diperlukan

• Tidak memiliki permission yang cukup
• Akun dibatasi oleh sistem

• Gunakan akun dengan akses lebih tinggi
• Periksa kebijakan sistem terkait akses edit

• Format nomor tidak sesuai
• Mengandung karakter yang tidak diperbolehkan

• Gunakan format nomor yang benar (angka saja atau sesuai standar sistem)
• Hindari spasi atau simbol tambahan

• Tidak ada device yang dipilih saat konfigurasi

• Edit kembali akses device
• Pastikan minimal satu device dipilih

• Device belum terdaftar dalam sistem
• Device berada di instansi berbeda

• Pastikan device sudah dibuat dan aktif
• Periksa kembali scope instansi

• Cache browser belum diperbarui
• Session belum sinkron

• Refresh halaman
• Logout dan login kembali jika diperlukan

• Pembatasan belum tersimpan dengan benar
• Ada konflik dengan konfigurasi lain

• Ulangi proses dan pastikan klik simpan
• Validasi kembali konfigurasi akses user

• Pastikan role sudah berhasil disimpan
• Refresh halaman atau reload sistem

• Pastikan permission sudah dikonfigurasi
• Periksa apakah ada override dari sistem lain

• Pastikan nama role tidak duplikat
• Periksa koneksi atau validasi input

• Role merupakan role default atau dilindungi sistem
• Anda tidak memiliki permission yang cukup

• Gunakan akun dengan akses lebih tinggi
• Periksa apakah role termasuk protected role

• Nama role sudah digunakan (duplikat)
• Input tidak valid (kosong atau karakter tidak diperbolehkan)

• Gunakan nama yang unik
• Pastikan format nama sesuai aturan sistem

• Cache browser belum diperbarui
• Sinkronisasi data tertunda

• Refresh halaman
• Logout dan login kembali jika diperlukan

• Tidak ada komunikasi perubahan
• Nama baru tidak cukup jelas

• Informasikan perubahan kepada pengguna terkait
• Gunakan nama yang lebih deskriptif dan familiar

• Pastikan halaman telah di-refresh
• Periksa apakah cache browser mempengaruhi tampilan

• Validasi kembali konfigurasi permission pada role
• Pastikan tidak ada konflik konfigurasi

• Periksa apakah Anda memiliki permission yang cukup
• Pastikan role tujuan tidak dibatasi oleh sistem

• Role masih digunakan oleh satu atau lebih pengguna
• Role termasuk role default sistem

• Pindahkan semua pengguna ke role lain melalui fitur Assign Role
• Pastikan role bukan bagian dari role bawaan sistem

• Data belum ter-refresh
• Role sudah dihapus sebelumnya

• Refresh halaman
• Periksa kembali dengan filter atau pencarian

• Anda tidak memiliki permission untuk menghapus role
• Role dilindungi oleh sistem (protected role)

• Gunakan akun dengan akses lebih tinggi (misalnya Admin)
• Periksa kebijakan sistem terkait role yang tidak bisa dimodifikasi

• Gangguan koneksi
• Validasi sistem gagal

• Coba ulangi proses beberapa saat kemudian
• Pastikan koneksi stabil

• Permission belum diberikan pada role
• Role yang digunakan tidak sesuai

• Periksa dan tambahkan permission yang diperlukan
• Validasi role pengguna

• UI menampilkan tombol, tetapi permission backend tidak mengizinkan

• Periksa konfigurasi permission di sistem
• Pastikan aksi yang dipilih sudah diaktifkan

• Cache browser belum diperbarui
• Sinkronisasi session belum terjadi

• Refresh halaman
• Logout dan login kembali jika diperlukan

• Permission berlaku global untuk role

• Buat role baru jika membutuhkan variasi akses
• Hindari perubahan langsung pada role yang digunakan banyak user

• Kalibrasi hanya berlaku untuk data baru, bukan data historis
• Tidak ada data baru yang masuk setelah kalibrasi disimpan
• Rumus tidak valid sehingga tidak dieksekusi

• Pastikan device mengirim data terbaru
• Cek timestamp data terakhir
• Periksa kembali rumus (hindari typo atau format salah)

• Rumus menghasilkan nilai tidak valid (misalnya pembagian dengan 0)
• Referensi parameter [parameter] tidak ditemukan
• Dataset tidak mengembalikan nilai (lookup gagal)

• Validasi rumus secara manual
• Pastikan ID sensor atau parameter benar
• Pastikan dataset memiliki range nilai yang sesuai dengan input

• Salah syntax (contoh: x + tanpa nilai lanjutan)
• Salah operator (misalnya ^ вместо **)
• Fungsi tidak didukung atau salah format

• Gunakan operator yang didukung (+ - * / **)
• Pastikan semua tanda kurung seimbang
• Gunakan fungsi sesuai dokumentasi (contoh: sqrt(x))

• ID sensor salah atau tidak ada di device yang sama
• Penulisan tidak sesuai format ([id_sensor])
• Sensor belum memiliki data

• Pastikan ID sensor benar (case-sensitive)
• Gunakan fitur = untuk memilih parameter otomatis
• Pastikan sensor referensi aktif dan mengirim data

• Slug dataset salah
• Kolom output tidak ditemukan
• Nilai input tidak ada dalam range dataset

• Periksa slug dataset sesuai yang disimpan
• Pastikan nama kolom output benar
• Pastikan dataset mencakup seluruh range nilai input (interpolasi jika perlu)

• Salah konversi unit (cm ke m, dll)
• Kesalahan dalam rumus (misalnya urutan operasi)
• Referensi parameter yang tidak sesuai

• Validasi dengan perhitungan manual
• Cek kembali unit sebelum dan sesudah kalibrasi
• Gunakan nilai sample untuk testing

• Sistem menggunakan Sintetik Data (hasil kalibrasi) untuk:
• Dashboard
• Grafik
• Laporan
• Sedangkan Raw Data hanya sebagai referensi

• Bandingkan raw vs sintetik melalui unduh data untuk validasi
• Pastikan rumus kalibrasi sudah benar

• Units hanya label, tidak mengubah nilai
• Nilai berubah hanya jika rumus kalibrasi diubah

• cm → m harus menggunakan x/100
• lalu update unit menjadi meter

• Kalibrasi belum disimpan
• Parameter tidak digunakan di dashboard
• Tidak ada data masuk

• Klik Simpan setelah input rumus
• Pastikan parameter digunakan di tampilan
• Tunggu data baru masuk

• Uji dengan sample data manual
• Gunakan nilai sederhana terlebih dahulu (misal x/100)
• Bandingkan hasil dengan perhitungan di luar sistem

• Hindari langsung menggunakan rumus kompleks tanpa validasi
• Bangun rumus secara bertahap

• Hindari menggunakan parameter turunan sebagai faktor kalibrasi.
• Lakukan kalibrasi yang sama untuk mendapat nilai dari parameter turunan, kemudian kalibrasikan perhitungan tersebut.

• Water level: 120-x
• Debit (virtual sensor): [water_level]*[velocity]
• Virtual sensor x: [debit]*10 -> tidak boleh akan error.

• Pastikan file berekstensi .csv
• Jika dari Excel, gunakan Export → CSV

• Sistem akan mencocokkan nilai sensor ke kolom pertama
• Kolom lain hanya digunakan sebagai output

• Lookup akan menghasilkan nilai yang tidak akurat atau kosong

• Header digunakan sebagai identifier kolom output dalam fungsi DATASET()
• Tanpa header, sistem tidak dapat mengenali kolom hasil

water_level,area
4.0,40.4
3.9,39.0
4.0,40.4
3.9,39.0

• Format file bukan CSV
• Tidak ada header di baris pertama
• Struktur kolom tidak sesuai
• File corrupt atau encoding tidak valid

• Pastikan format CSV valid
• Gunakan delimiter koma (,)
• Pastikan file dapat dibuka di editor teks

• Nilai input tidak ditemukan dalam kolom referensi
• Slug dataset salah
• Nama kolom output tidak sesuai header

• Pastikan nilai input berada dalam range dataset
• Periksa slug dataset
• Gunakan nama kolom output sesuai header (case-sensitive)

• Data yang terurut mempermudah proses lookup
• Mengurangi risiko hasil tidak akurat

• Urutkan data secara konsisten (ascending atau descending)

• Sistem dapat menghasilkan output yang tidak konsisten
• Lookup menjadi ambigu

• Pastikan setiap nilai referensi unik

• Sistem melakukan lookup berdasarkan nilai yang tersedia
• Jika nilai tidak ditemukan secara langsung, hasil bisa kosong atau tidak akurat

• Gunakan interval data yang lebih rapat
• Tambahkan nilai di antara (intermediate values) jika diperlukan

• DATASET(“slug”, x, “area”)
• DATASET(“slug”, x, “volume”)

• File terlalu besar
• Format tidak sesuai
• Header kosong atau duplikat
• Encoding tidak standar (bukan UTF-8)

• Gunakan CSV dengan encoding UTF-8
• Pastikan header unik dan tidak kosong
• Periksa batas ukuran file

• Dataset hanya berlaku untuk data setelah konfigurasi disimpan
• Data historis tidak akan berubah

• Kolom pertama = referensi (input)
• Baris pertama = header
• Tidak ada nilai kosong di kolom referensi
• Range data mencakup nilai sensor
• Tidak ada duplikasi nilai referensi

• Uji dengan beberapa nilai sample
• Bandingkan hasil manual dengan hasil sistem

​

Kemungkinan Penyebab

• Device mati
• Kehabisan daya
• Gangguan jaringan
• SIM card tidak aktif
• Modem bermasalah

​

Langkah Pengecekan

1. Pastikan device dalam kondisi menyala
2. Periksa sumber daya / baterai
3. Verifikasi koneksi internet
4. Cek kualitas sinyal modem
5. Restart device apabila diperlukan

​

Rekomendasi

​

Kemungkinan Penyebab

• Koneksi jaringan tidak stabil
• Server mengalami latency
• Interval pengiriman terlalu kecil
• Gangguan modem sementara

​

Langkah Pengecekan

1. Periksa kualitas sinyal
2. Pastikan koneksi internet stabil
3. Verifikasi interval pengiriman device
4. Monitor apakah status berubah menjadi offline

​

Informasi

​

Rekomendasi

• Dokumentasikan aktivitas maintenance
• Nonaktifkan alarm sementara jika diperlukan
• Pastikan status dikembalikan setelah maintenance selesai