Panduan Jalinara

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.

  1. Di sidebar, buka Perangkat & API › Dokumentasi API, lalu catat Base URL dan format Autentikasi.

  2. 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"

  3. Kirim satu pesan teks ke nomor Anda sendiri dengan permintaan di bawah. Ganti 6280000000110 (nomor fiktif) dengan nomor Anda, dalam format 62….

    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."}'

  4. Buka Laporan › Log Pesan, lalu ketik nomor tujuan di Cari nomor… (cara memakai Log Pesan).

    Log Pesan menampilkan pesan uji keluar yang dikirim lewat API ke nomor tujuan Perbesar
  5. Kembali ke Perangkat & API › API Token, lalu lihat kolom Terakhir dipakai pada baris token Anda.

    Tabel API Token setelah uji, kolom Terakhir dipakai berisi waktu pemakaian terakhir 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:

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.