API Documentation

Getting Started

Selamat datang di dokumentasi API Kirimi! Panduan ini akan membantu Anda memulai integrasi WhatsApp dengan aplikasi Anda.

Base URL

https://api.kirimi.id

Autentikasi

Setiap request API memerlukan kredensial berikut:

user_code - Kode pengguna unik Anda dari dashboard
secret - Kunci rahasia untuk autentikasi API
device_id - ID perangkat WhatsApp yang terhubung (untuk endpoint tertentu)

Penting

Jaga kerahasiaan Secret Key Anda
Regenerate Secret Key secara berkala untuk keamanan
Gunakan HTTPS untuk semua API request

Response Format

Semua response API menggunakan format JSON:

{
  "success": true,
  "message": "Pesan berhasil dikirim",
  "data": {
    "message_id": "msg_123456",
    "status": "sent"
  }
}

API Endpoints

API untuk mengirim pesan teks dan media (gambar, video, dokumen) ke nomor WhatsApp.

Send Message

POSThttps://api.kirimi.id/v1/send-message

Request Payload

{
  "user_code": "YOUR-USER-CODE",
  "device_id": "YOUR-DEVICE-ID",
  "receiver": "6281234567890",
  "message": "Hello from Kirimi API!",
  "secret": "YOUR-SECRET-KEY"
}

Parameters

Parameter	Type	Required	Description
user_code	string	Required	Kode pengguna Anda dari akun Kirimi
device_id	string	Required	ID perangkat yang sudah terdaftar
receiver	string	Required	Nomor WhatsApp penerima (format: 6281234567890)
message	string	Required	Pesan teks yang akan dikirim
secret	string	Required	Kunci rahasia untuk autentikasi
media_url	string	Optional	URL file media (gambar/video/audio/dokumen)

Broadcast Message

POSThttps://api.kirimi.id/v1/broadcast-message

Request Payload

{
  "user_code": "YOUR-USER-CODE",
  "device_id": "YOUR-DEVICE-ID",
  "label": "Campaign Name",
  "numbers": [
    "6281234567890",
    "6289876543210"
  ],
  "message": "Broadcast message content",
  "secret": "YOUR-SECRET-KEY",
  "delay": 30
}

Parameters

Parameter	Type	Required	Description
user_code	string	Required	Kode pengguna Anda dari akun Kirimi
device_id	string	Required	ID perangkat terdaftar Anda
label	string	Required	Label broadcast untuk identifikasi
numbers	array	Required	Array nomor telepon penerima
message	string	Required	Pesan yang akan dikirim
secret	string	Required	Kunci rahasia untuk autentikasi
delay	number	Optional	Delay antar pesan dalam detik (min: 5, recommended: 30)

Contoh Kode

Berikut adalah contoh implementasi untuk mengirim pesan menggunakan berbagai bahasa pemrograman.

API Documentation

Getting Started

Base URL

Autentikasi

Penting

Response Format

API Endpoints

Send Message

Request Payload

Parameters

Broadcast Message

Request Payload

Parameters

Contoh Kode

Pertanyaan Umum

Siap untuk memulai?