Langsung ke konten
ID EN

Ringkasan

2 min read

Base URL

Semua permintaan API publik mengarah ke:

https://api.kirisan.com

Gunakan host ini di produksi. Lingkungan lokal bisa memakai base URL lain yang diatur di dashboard — produksi harus selalu menargetkan https://api.kirisan.com.

Autentikasi

Setiap permintaan memerlukan token API akun Anda:

Authorization: Bearer YOUR_ACCOUNT_TOKEN

Salin token dari Account → Settings di dashboard. Lihat Authentication untuk channel key dan rotasi token.

Endpoint yang tersedia

MethodPathTujuan
POST/v1/sendKirim ke satu penerima (opsional di beberapa channel)
GET/v1/templatesDaftar template (opsional ?channel=)
GET/v1/templates/:idAmbil satu template

Tidak ada endpoint bulk-send publik terpisah. Untuk pengiriman massal, gunakan Send → Campaign di dashboard, atau panggil POST /v1/send sekali per penerima dari aplikasi Anda.

Buat dan kelola template pesan di dashboard di Channel → channel → Templates. Daftar ID lewat Templates API, lalu gunakan di body send, atau kirim konten pesan inline — lihat Send API.

Format respons

Respons berhasil menyertakan "status": true.

Error berisi "status": false dan string "reason". Status HTTP 401/403 untuk masalah autentikasi; banyak error validasi memakai 400. Lihat Errors untuk daftar lengkap.

POST /v1/send menambahkan objek "channels" dengan hasil per channel:

{
  "status": true,
  "channels": {
    "whatsapp": { "status": true, "processing_time": "120ms" }
  }
}

Send terjadwal juga menyertakan "scheduled": true di tingkat atas dan pada setiap channel.

Alur integrasi tipikal

  1. Salin token akun dari Account → Settings.
  2. Salin channel key (token device atau pengirim) dari halaman Channel → … yang relevan.
  3. Susun content dengan pesan inline, atau daftar template lewat GET /v1/templates dan referensikan id-nya.
  4. Panggil POST /v1/send dengan keys, content, dan target.
  5. Baca "status" dan setiap entri di bawah "channels" — alasan kegagalan per channel.

Layar Send di dashboard memakai endpoint /v1/send yang sama — perilaku API cocok dengan yang Anda lihat di UI.

Terkait

Was this page helpful?