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

• API key tersimpan di frontend
• Repository tidak diamankan

• Segera rotasi API key
• Pindahkan kredensial ke server-side
• Gunakan secret manager jika tersedia

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

• Pastikan header dikirim dengan benar
• Periksa format: api_key:secret_key sebelum encoding
• Generate ulang Base64

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

• Periksa permission API key
• Hubungi pihak Mertani jika diperlukan

• 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
}

• Interval umum: 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

1. Validasi device
2. Validasi format data
3. Normalisasi
4. Penyimpanan ke database

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

• 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

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

• 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

• Polling terlalu cepat sebelum data tersedia
• Parameter waktu tidak sesuai
• Cache pada client

• Sesuaikan interval polling dengan device
• Gunakan filter timestamp terbaru
• Disable cache jika diperlukan

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

• Validasi endpoint dan parameter
• Periksa scope akses API key

• Sensor error atau tidak terkalibrasi
• Data duplikat atau missing

• Lakukan kalibrasi sensor
• Validasi data di level aplikasi

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

• Periksa endpoint server Anda
• Validasi URL dan pastikan response status mengembalikan 200 OK

• 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

• 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

• 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, sesuai standar sistem)
• Hindari spasi atau simbol tambahan

• Form belum diisi dengan benar / validasi sistem gagal
• Cache browser belum diperbarui

• Pastikan semua field wajib sudah diisi dan format data benar
• Refresh halaman atau logout dan login kembali

• 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

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

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

• Nama role duplikat
• Input tidak valid atau koneksi bermasalah

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

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

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

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

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

• Tidak ada komunikasi perubahan ke pengguna

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

• Salah memilih role saat invite
• Perubahan belum tersimpan

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

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

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

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

• Periksa dan tambahkan permission yang diperlukan
• Validasi role pengguna

• Pastikan permission sudah dikonfigurasi dan tersimpan
• Periksa apakah ada override dari konfigurasi lain

• 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

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

• 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

• 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

• Data belum ter-refresh
• Role sudah dihapus sebelumnya

• Refresh halaman
• Periksa kembali dengan filter atau pencarian

• Gangguan koneksi
• Validasi sistem gagal

• Coba ulangi proses beberapa saat kemudian
• Pastikan koneksi stabil

• 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 ^ seharusnya **)
• 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 secara otomatis
• Pastikan sensor referensi aktif dan mengirim data

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

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

• Ubah rumus kalibrasi sesuai unit baru
• Contoh: cm → m harus menggunakan x/100, lalu update unit menjadi meter

• Uji dengan sample data manual
• Gunakan nilai sederhana terlebih dahulu (misal x/100)
• Bandingkan hasil dengan perhitungan di luar sistem
• Bangun rumus secara bertahap, hindari langsung menggunakan rumus kompleks

• 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

• 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

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

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

• Urutkan data secara konsisten (ascending atau descending)

• Pastikan setiap nilai referensi unik

water_level,area,volume,flow

• DATASET("slug", x, "area")
• DATASET("slug", x, "volume")

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

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

• Pastikan format CSV valid dengan delimiter koma (,)
• Gunakan encoding UTF-8
• Pastikan file dapat dibuka di editor teks

• File terlalu besar
• 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 yang diizinkan

• 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)

• 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 dan bandingkan hasil manual dengan hasil sistem

​

Kemungkinan Penyebab

• Device mati atau 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

Jika device tetap offline lebih dari 24 jam, lakukan pengecekan lapangan.

​

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

​

Rekomendasi

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