Autentikasi

2 min read

Token API akun

API publik menggunakan token API akun Kirisan — bukan cookie sesi dashboard.

Masuk di dash.kirisan.com.
Buka Account → Settings.
Salin API token (atau Regenerate token jika token bocor).

Kirim token pada setiap permintaan:

Authorization: Bearer YOUR_ACCOUNT_TOKEN
Content-Type: application/json

Token mengidentifikasi akun pengguna Anda. Kirisan memastikan setiap channel key dalam permintaan milik akun yang sama.

Channel key

POST /v1/send juga memerlukan channel key di body JSON — token yang mengidentifikasi device WhatsApp, bot Telegram, pengirim email, atau nomor WABA mana yang mengirim pesan.

{
  "keys": {
    "whatsapp": { "token": "DEVICE_TOKEN" },
    "email": { "token": "EMAIL_SENDER_TOKEN" }
  }
}

Channel	Tempat menemukan key
WhatsApp	Channel → WhatsApp → Devices — token device (ditampilkan saat device terhubung)
Telegram	Channel → Telegram → Devices — token bot
WABA	Channel → WABA → Devices — token nomor
Email	Channel → Email → Emails — token API per pengirim

Sertakan hanya channel yang Anda gunakan untuk mengirim. Setiap key harus milik akun Anda — jika tidak, Kirisan mengembalikan 403.

Fallback key

Field opsional pada setiap key mengontrol pengiriman berjenjang (sama seperti Use as fallback di Send → Send):

Field	Tipe	Arti
`fallback`	boolean	`true` — channel ini fallback, bukan utama
`fallback_sequence`	integer	Urutan tier — `1` dijalankan sebelum `2`; sequence sama dikirim paralel

Channel utama (tanpa fallback) dikirim dulu. Jika semuanya gagal, Kirisan mencoba fallback tier 1, lalu tier 2, sampai satu channel berhasil. Lihat Send API.

Regenerasi token

Jika token bocor, klik Regenerate token di Account → Settings. Token lama langsung berhenti berfungsi — perbarui setiap skrip, server, dan integrasi yang memanggil API.

Respons tidak sah

Status HTTP	Arti
`401`	Bearer token hilang, atau token tidak ditemukan di akun Anda
`403`	Bearer token valid tetapi channel key milik pengguna lain

GET /v1/templates hanya memerlukan Bearer token akun — channel key tidak dipakai. Channel key wajib hanya untuk POST /v1/send.

Terkait

Overview — base URL dan endpoint
Send API — tempat keys dalam permintaan
Templates API — daftar template dengan Bearer token saja
Errors — pesan autentikasi dan validasi
Settings & support — salin token di dashboard