For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
DocsDashboardAPI ReferenceFAQ
DocsDashboardAPI ReferenceFAQ
  • Overview
    • Welcome
    • How Does Mertani Work?
    • Integration Method
    • Authentication
    • Struktur Data
    • Daftar Sensor ID
  • External API
    • GETGet list devices
    • GETGet device sensor data
  • Webhook API
    • POSTReceive Sensor Data
Dashboard
LogoLogo
On this page
  • Overview
  • Alur utama:
  • 1. REST API (Pull-Based)
  • Cara Kerja
  • Karakteristik
  • Use Case
  • 2. Webhook API (Push-Based)
  • Cara Kerja
  • Karakteristik
  • Use Case
  • Perbandingan REST API vs Webhook
  • Behavior Sistem
  • Best Practice Integrasi
  • REST API
  • Webhook
Overview

Integration Method

||View as Markdown|
Was this page helpful?
Edit this page
Previous

How Does Mertani Work?

Next

Authentication

Built with

Overview

Mertani menyediakan dua metode utama untuk integrasi data, yang dirancang untuk kebutuhan konsumsi data yang berbeda:

  1. REST API (Pull-Based) → Client mengambil data dari Mertani
  2. Webhook API (Push-Based) → Mertani mengirim data ke client

Kedua metode ini berjalan di atas arsitektur yang sama, namun memiliki pola komunikasi yang berbeda.

Alur utama:

1

Data Logger mengumpulkan data dari sensor

2

Data dikirim melalui Gateway

3

Diterima oleh Mertani Backend

4

Disimpan di Database

5

Data dapat diakses melalui REST API Mertani

1. REST API (Pull-Based)

Pada metode ini, client secara aktif mengambil data dari server Mertani melalui endpoint API.

restapi-lightrestapi-dark

Cara Kerja

  • Client mengirim request ke endpoint API
  • Backend membaca data dari database
  • Data dikembalikan dalam format JSON

Karakteristik

  • Request-based (GET)
  • Bersifat pull (client yang mengontrol pengambilan data)
  • Mendukung data historis dan agregasi
  • Tidak real-time (tergantung interval polling)

Use Case

  • Dashboard monitoring
  • Data analytics
  • Reporting
  • Integrasi BI tools

2. Webhook API (Push-Based)

Pada metode ini, Mertani akan secara otomatis mengirim data ke endpoint milik client setiap kali ada data baru.

webhook-lightwebhook-dark

Cara Kerja

  • Device mengirim data ke backend
  • Backend memproses data
  • Backend melakukan HTTP POST ke endpoint client
  • Client menerima data secara langsung

Karakteristik

  • Event-driven (POST)
  • Bersifat push (server yang mengirim data)
  • Mendukung real-time data streaming
  • Tidak memerlukan polling

Use Case

  • Sistem notifikasi / alerting
  • Monitoring real-time
  • Integrasi event-driven system
  • Automation pipeline

Perbandingan REST API vs Webhook

FeatureREST APIWebhook API
ModelPullPush
TriggerClient requestEvent dari sistem
Real-timeTidak langsungYa
Beban ServerDi clientDi server penerima
KompleksitasLebih sederhanaPerlu endpoint publik
Use CaseDashboard, reportAlerting, automation

Behavior Sistem

  • Kedua metode membaca data dari sumber yang sama (database Mertani)
  • REST API tidak pernah mengambil data langsung dari device
  • Webhook hanya aktif jika dikonfigurasi
  • Data yang dikirim mengikuti interval dari device

REST API dan Webhook dapat digunakan bersamaan untuk kebutuhan yang berbeda, misalnya dashboard menggunakan REST API dan alert system menggunakan Webhook.

Best Practice Integrasi

Untuk implementasi optimal:

REST API

  • Gunakan parameter timestamp filter untuk efisiensi
  • Hindari polling terlalu sering
  • Gunakan caching untuk performa

Webhook

  • Pastikan endpoint memiliki high availability
  • Implementasikan retry mechanism
  • Validasi request (signature/token) untuk keamanan