Dokumentasi API

Selamat datang di API Aksita.ai. Kami telah membangun platform yang kokoh untuk memberdayakan developer mengintegrasikan agen AI yang cerdas dan context-aware ke dalam ekosistem digital apapun. Baik Anda membangun bot customer support untuk WhatsApp, asisten interaktif untuk website Anda, atau workflow automation yang kompleks, API kami menyediakan building block yang Anda butuhkan.

REST API kami dirancang dengan pengalaman developer sebagai prioritas—menampilkan URL yang predictable, kode response HTTP standar, dan response JSON yang sederhana.

Performa Tinggi

Dirancang untuk kecepatan. Infrastruktur kami dioptimalkan untuk memberikan response dengan latency ultra-rendah, memastikan interaksi user terasa natural dan instant.

Keamanan Enterprise

Keamanan data Anda adalah prioritas utama. Semua interaksi dilindungi dengan API key yang aman, aturan validasi yang ketat, dan protokol enkripsi tingkat bank.

URL Dasar

Semua request API harus diawali dengan URL dasar berikut:

https://api.aksita.ai/api

Mulai Cepat

Mulai gunakan API Aksita.ai dalam 3 langkah sederhana:

Buat API Key Anda

Buka dashboard agent Anda, masuk ke tab <strong>API Keys</strong>, dan buat API key. Pilih nama dan format response (Markdown, WhatsApp, Custom, dll.).

Buat Sesi

Buat POST request ke <code>/api/session</code> untuk membuat sesi percakapan baru.

Kirim Pesan

Gunakan session ID untuk mengirim pesan dan menerima response AI via <code>/api/chat</code>.

Contoh Alur Lengkap (cURL)

# Langkah 1: Buat Sesi
curl -X POST https://api.aksita.ai/api/session \
  -H "X-API-Key: api_key_anda" \
  -H "Content-Type: application/json"

# Langkah 2: Kirim Pesan
curl -X POST https://api.aksita.ai/api/chat \
  -H "X-API-Key: api_key_anda" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "session_id_dari_langkah_1",
    "message": "Halo, bagaimana Anda bisa membantu saya?"
  }'

Format Response AI

Setiap API key memiliki <strong>format response</strong> sendiri yang mengontrol bagaimana AI memformat responsenya. Ini memungkinkan Anda menggunakan agent yang sama di berbagai platform dengan format yang spesifik untuk platform tersebut.

Markdown

Format markdown standar - ideal untuk aplikasi web dan dokumentasi.

Dioptimalkan untuk WhatsApp dengan format dan line break yang sesuai.

Platform Custom

Tentukan nama platform (Discord, Telegram, Slack) untuk format spesifik platform.

Contoh Custom

Berikan contoh pesan chat untuk memandu format response AI.

Contoh Penggunaan

Buat 3 API key untuk agent yang sama: satu dengan format "WhatsApp" untuk bot WhatsApp Anda, satu dengan "markdown" untuk chat website Anda, dan satu dengan "Custom Platform: Discord" untuk server Discord Anda. Setiap integrasi mendapatkan response yang diformat optimal!

Struktur Response API

Aksita.ai menggunakan envelope JSON yang konsisten untuk semua response API. Setiap response akan berisi field <code>status</code> yang menunjukkan sukses atau gagal.

Response Sukses

{
  "status": true,
  "data": {
    // Objek data yang diminta
  },
  "detail": "Operasi berhasil"
}

Response Error

{
  "status": false,
  "reason": "Deskripsi kesalahan yang terjadi"
}