Integrasi & API
Cara Menguji API untuk Pertama Kali
Uji token API dengan dua permintaan aman: cek status perangkat, lalu kirim satu pesan uji. Periksa hasilnya di Log Pesan.
Setelah token dibuat, uji dulu sebelum dipasang di website atau n8n. Urutannya dari permintaan yang tidak mengirim pesan (cek status perangkat) ke permintaan yang mengirim satu pesan. Halaman ini untuk tim teknis, atau pemilik yang dibantu tim teknis.
Siapkan dulu token yang sudah dibuat (caranya; token baru langsung aktif), satu perangkat berstatus Terhubung, dan alat uji seperti terminal, Postman, atau node HTTP Request di n8n. Contoh di bawah memakai TOKEN_ANDA sebagai pengganti token asli.
-
Di sidebar, buka Perangkat & API › Dokumentasi API, lalu catat Base URL dan format Autentikasi.
-
Jalankan permintaan ini dari alat uji untuk memeriksa status perangkat. Permintaan ini tidak mengirim pesan dan tidak memakai kuota.
curl https://app.jalinara.id/device -H "Authorization: Bearer TOKEN_ANDA" -
Kirim satu pesan teks ke nomor Anda sendiri dengan permintaan di bawah. Ganti
6280000000110(nomor fiktif) dengan nomor Anda, dalam format62….curl -X POST https://app.jalinara.id/send -H "Authorization: Bearer TOKEN_ANDA" -H "Content-Type: application/json" -d '{"target": "6280000000110", "message": "Tes API. Abaikan pesan ini."}' -
Buka Laporan › Log Pesan, lalu ketik nomor tujuan di Cari nomor… (cara memakai Log Pesan).
Perbesar -
Kembali ke Perangkat & API › API Token, lalu lihat kolom Terakhir dipakai pada baris token Anda.
Perbesar
Kalau hasilnya tidak sesuai
| Gejala | Perbaikan |
|---|---|
| Respons 401 | Token tidak dikenali. Periksa header Authorization, pastikan token tidak ditaruh di URL, dan pastikan Status token tidak Nonaktif. |
| Respons 402 | Paket belum termasuk fitur yang diminta. Buka Langganan. |
| Respons 403 | Token dibatasi ke perangkat lain. Cek kolom Perangkat di tabel API Token. |
connected bernilai false |
Perangkat terputus. Sambungkan ulang, lalu ulangi langkah 2. |
| Terakhir dipakai tetap Belum pernah | Permintaan ditolak sebelum token dikenali. Baca pesan error di respons. |
Penjelasan lengkap kode error ada di Batas Pemakaian dan Kode Error API.
Referensi: alamat, token, dan endpoint
Dokumentasi resmi ada di menu Dokumentasi API dan di halaman publik jalinara.id/developer.
Alamat dasar (Base URL) akun pelanggan adalah https://app.jalinara.id. Token dikirim lewat header Authorization. Tiga bentuk ini sama-sama diterima:
Authorization: Bearer TOKEN_ANDAAuthorization: Token TOKEN_ANDAAuthorization: TOKEN_ANDA
| Metode | Jalur | Fungsi | Catatan |
|---|---|---|---|
| POST | /send |
Kirim pesan teks, media, atau lokasi | Panduan kirim pesan |
| GET | /device |
Cek status perangkat | Tidak mengirim pesan |
| POST | /validate |
Cek apakah nomor terdaftar di WhatsApp | Tidak memakai kuota |
| GET | /api/gateway/messages/:id |
Status satu pesan | Daftar pesan: /api/gateway/messages |
| POST, GET, DELETE | /api/gateway/schedules |
Buat, lihat, dan batalkan jadwal kirim | Panduan jadwal |
| PUT, DELETE | /api/gateway/webhook |
Pasang atau hapus webhook perangkat | Panduan webhook |
Belum ketemu jawabannya? Buka menu Bantuan di dashboard Jalinara dan kirim tiket ke tim kami.