Dokumentasi

Satu API key untuk semua layanan. Mulai dari host, autentikasi, dan webhook.

Host dan autentikasi

Buat API key di dasbor, lalu kirim di header. Key bisa dibatasi ke IP tertentu dan dicabut kapan saja.

LayananHostHeader
WhatsApphttps://gateway.larika.idAuthorization: Bearer <key> atau x-api-key: <key>
AIhttps://ai.larika.idAuthorization: Bearer <key>
Payment (QRIS)https://api.larika.idx-api-key: <key> atau Authorization: Bearer <key>
CCTVhttps://cctv.larika.idAuthorization: Bearer <key> atau x-api-key: <key>

Webhook

WhatsApp dan CCTV mengirim kejadian ke URL webhook Anda. Setiap permintaan membawa header x-larika-event dan x-larika-webhook-key. Cocokkan nilai yang kedua dengan kunci webhook Anda sebelum memproses.

app.post('/webhook', express.json(), (req, res) => {
  // header ini berisi kunci webhook Anda; tolak bila tidak sama
  if (req.get('x-larika-webhook-key') !== process.env.LARIKA_WEBHOOK_KEY) return res.sendStatus(401);

  const event = req.get('x-larika-event');   // contoh: message.incoming
  handle(event, req.body);

  res.sendStatus(200);                        // selain 2xx, Larika mengirim ulang
});

Bila URL Anda tidak menjawab 2xx, Larika mengirim ulang dengan jeda yang berlipat dua mulai dari 5 detik, maksimum 1 jam. Pengiriman untuk satu klien berjalan berurutan.

Referensi tiap layanan

  • WhatsApp

    Semua endpoint dengan contoh permintaan dan jawaban.

    Buka →

  • AI

    Endpoint chat, model, dan gambar dengan contoh curl.

    Buka →

  • Payment (QRIS)

    Tagihan QRIS dan invoice dengan contoh curl.

    Buka →

  • CCTV

    Kamera, snapshot, live view, rekaman, kejadian, dan webhook.

    Buka →