Dokumentasi · flodenotify

📖 Konsep dasar

flodenotify adalah server notifikasi pub/sub: kamu kirim pesan ke sebuah topik, dan semua yang berlangganan topik itu (app HP, stream, Telegram) langsung menerimanya.

https://https://notif.kimlabs.id/<topik>          ← kirim pesan (POST)
https://https://notif.kimlabs.id/<topik>/json    ← baca/stream pesan

Topik dibuat otomatis saat pertama kali dipakai. Tiap topik milik user pembuatnya; user lain tidak bisa mengakses (kecuali admin).

🔑 Autentikasi — API key

Semua akses API wajib pakai API key (buat di Dashboard → API Keys). Tiga cara:

# 1. Header Authorization
Authorization: Bearer flodenotify_xxxx

# 2. Header khusus
X-API-Key: flodenotify_xxxx

# 3. Query param (praktis untuk app ntfy)
https://https://notif.kimlabs.id/topik/json?apikey=flodenotify_xxxx

📤 Mengirim notifikasi

curl -H "Authorization: Bearer flodenotify_xxx" \
     -H "X-Title: Deploy Selesai" \
     -H "X-Priority: 4" \
     -H "X-Tags: rocket,deploy" \
     -d "Build v1.2.3 sukses di server produksi" \
     https://https://notif.kimlabs.id/deploy

Header	Isi	Efek
`X-Title`	teks	Judul pesan (tampil tebal di Telegram)
`X-Priority`	1–5	⬇️1 · 🔹2 · (3 default) · ⚠️4 · 🚨5
`X-Tags`	dipisah koma	Tag/hashtag, mis. `warning,rotating_light`

Batas ukuran pesan 4 KB. Body kosong → 400.

📥 Menerima notifikasi

A. App ntfy di HP: Install ntfy → Add subscription → server https://https://notif.kimlabs.id → topik kimnotif → isi username & API key saat diminta.

B. Stream real-time:

curl -N -H "Authorization: Bearer flodenotify_xxx" https://https://notif.kimlabs.id/deploy/json

C. Poll riwayat:

curl -H "Authorization: Bearer flodenotify_xxx" "https://https://notif.kimlabs.id/deploy/json?poll=1"

Cache 200 pesan/topik, kadaluarsa 24 jam.

✈️ Telegram fan-out

Admin isi bot_token di config.json, telegram.enabled: true, restart
Chat bot dulu di Telegram (bot perlu tahu chat_id-mu)
Dashboard → Telegram → pasangkan topik → chat_id

Format MarkdownV2: judul tebal, tag = hashtag, prioritas ≥4 ⚠️, ≥5 🚨.

🔌 Contoh integrasi

bash / cron

DISK=$(df -h / | awk 'NR==2{print $5}')
curl -s -H "Authorization: Bearer flodenotify_xxx" \
     -H "X-Title: ⚠️ Disk Alert" -H "X-Priority: 4" \
     -d "Pemakaian disk: $DISK" \
     https://https://notif.kimlabs.id/server-alert

Python

import requests
requests.post("https://https://notif.kimlabs.id/bot-status",
    data="Hermes restart selesai",
    headers={"Authorization": "Bearer flodenotify_xxx",
             "X-Title": "🤖 Bot", "X-Tags": "robot"})

Google Apps Script

UrlFetchApp.fetch("https://https://notif.kimlabs.id/spreadsheet", {
  method: "post",
  payload: pesan,
  headers: { "Authorization": "Bearer flodenotify_xxx",
             "X-Title": "Sheet Update" }
});

n8n (HTTP Request node)

Method: POST   URL: https://https://notif.kimlabs.id/n8n-workflow
Headers:  Authorization: Bearer flodenotify_xxx
          X-Title: n8n Workflow
Body:     status workflow...

Node.js

await fetch("https://https://notif.kimlabs.id/app-event", {
  method: "post",
  body: "User baru: " + email,
  headers: { "Authorization": "Bearer flodenotify_xxx",
             "X-Title": "👋 User Baru" }
});

❓ Troubleshooting

401 butuh API key	Key salah/dicabut — cek Dashboard
403 topik bukan milik Anda	Topik milik user lain
429	Rate limit (120/menit) — tunggu sebentar
Tidak masuk Telegram	Pasangan topik→chat_id belum ada, atau bot belum di-Start
Stream terputus	Idle timeout — client retry; riwayat via `?poll=1`

🔐 Keamanan ringkas

Password bcrypt + lockout 5 menit setelah 5× gagal
API key bisa dicabut/dihapus kapan saja
Rate limit per user + audit log di Admin
HTTPS wajib (nginx + Let's Encrypt)