API Reference
Referensi lengkap semua REST API ConAI. 43+ endpoint yang mencakup Neural Core, Provisioning, Autoscale, Skill Pack SDK, Billing, dan operasional sistem.
43+
Total Endpoint
6
API Groups
2
Auth Methods
v1
Base Version
Authentication
Semua API endpoint memerlukan autentikasi. ConAI mendukung dua metode autentikasi.
Bearer Token (JWT)
Untuk akses user-scoped. Token didapat dari login endpoint.
Authorization: Bearer eyJhbGciOi...
API Key
Untuk akses service-to-service. Key di-generate dari Dashboard.
X-API-Key: cai_live_abc123...
Rate Limiting
Semua endpoint dilindungi rate limit. Default: 100 request/menit untuk JWT, 1000 request/menit untuk API Key. Response header X-RateLimit-Remaining menunjukkan sisa quota. Saat limit tercapai, response 429 dengan header Retry-After.
Neural Core V2
Inference engine untuk AI Agent — intent classification, response generation, dan multi-agent orchestration.
/api/v1/neuralAuth: Bearer Token (JWT)| Method | Endpoint | Deskripsi |
|---|---|---|
| POST | /api/v1/neural/infer | Jalankan inference — kirim prompt, terima response dari AI Agent |
| POST | /api/v1/neural/orchestrate | Multi-agent orchestration — kirim task ke beberapa agent sekaligus |
| GET | /api/v1/neural/agents | List semua AI Agent yang aktif |
| GET | /api/v1/neural/agents/:id | Detail konfigurasi agent tertentu |
| PUT | /api/v1/neural/agents/:id | Update konfigurasi agent |
| GET | /api/v1/neural/sessions | List sesi percakapan aktif |
| GET | /api/v1/neural/sessions/:id/history | Riwayat percakapan agent dengan user |
| POST | /api/v1/neural/context | Inject context/knowledge ke agent |
Provisioning API
Integrasi MikroTik RouterOS, OLT, dan sistem penagihan untuk ISP.
/api/v1/provisioningAuth: Bearer Token (JWT)| Method | Endpoint | Deskripsi |
|---|---|---|
| GET | /api/v1/provisioning/devices | List semua perangkat jaringan (MikroTik, OLT) |
| POST | /api/v1/provisioning/devices | Daftarkan perangkat baru |
| POST | /api/v1/provisioning/pppoe/create | Buat PPPoE secret baru untuk pelanggan |
| DELETE | /api/v1/provisioning/pppoe/:username | Hapus PPPoE secret |
| POST | /api/v1/provisioning/bandwidth/set | Set bandwidth limit untuk pelanggan |
| GET | /api/v1/provisioning/pppoe/active | List PPPoE sessions aktif |
| POST | /api/v1/provisioning/olt/onu | Provisioning ONU di OLT |
| GET | /api/v1/provisioning/olt/onu/:sn/status | Status ONU berdasarkan serial number |
Sovereign Autoscale
Pengelolaan resource VPS secara dinamis berdasarkan demand dan kebijakan.
/api/v1/autoscaleAuth: Bearer Token (JWT) + Service Key| Method | Endpoint | Deskripsi |
|---|---|---|
| GET | /api/v1/autoscale/policies | List kebijakan autoscale yang aktif |
| POST | /api/v1/autoscale/policies | Buat kebijakan autoscale baru |
| PUT | /api/v1/autoscale/policies/:id | Update kebijakan autoscale |
| DELETE | /api/v1/autoscale/policies/:id | Hapus kebijakan autoscale |
| GET | /api/v1/autoscale/vps | List VPS dengan status resource saat ini |
| POST | /api/v1/autoscale/vps/:id/resize | Trigger resize VPS manual |
| GET | /api/v1/autoscale/events | Riwayat autoscale events |
Skill Pack SDK
Manage Skill Packs — upload, install, test, dan distribusi custom skill.
/api/v1/sdkAuth: API Key| Method | Endpoint | Deskripsi |
|---|---|---|
| POST | /api/v1/sdk/packs | Upload & publikasi Skill Pack baru |
| GET | /api/v1/sdk/packs | List Skill Pack yang tersedia |
| GET | /api/v1/sdk/packs/:id | Detail Skill Pack |
| PUT | /api/v1/sdk/packs/:id | Update metadata Skill Pack |
| DELETE | /api/v1/sdk/packs/:id | Hapus Skill Pack |
| POST | /api/v1/sdk/packs/:id/install | Install Skill Pack ke Agent |
| POST | /api/v1/sdk/packs/:id/test | Jalankan test suite di sandbox |
Billing & Payments
Langganan, invoice, pembayaran, dan manajemen paket.
/api/v1/billingAuth: Bearer Token (JWT)| Method | Endpoint | Deskripsi |
|---|---|---|
| GET | /api/v1/billing/subscription | Status langganan saat ini |
| POST | /api/v1/billing/subscription/upgrade | Upgrade paket langganan |
| POST | /api/v1/billing/subscription/cancel | Batalkan langganan |
| GET | /api/v1/billing/invoices | List semua invoice |
| GET | /api/v1/billing/invoices/:id | Detail invoice |
| POST | /api/v1/billing/payment/create | Buat pembayaran baru (generates payment link) |
| GET | /api/v1/billing/payment/:id/status | Status pembayaran |
Operations
Runbook execution, monitoring, dan webhook management.
/api/v1/opsAuth: Bearer Token (JWT)| Method | Endpoint | Deskripsi |
|---|---|---|
| GET | /api/v1/runbooks | List semua runbook |
| POST | /api/v1/runbooks/:id/execute | Jalankan runbook |
| GET | /api/v1/ops/alerts | List alert aktif |
| POST | /api/v1/ops/webhooks | Daftarkan webhook baru |
| GET | /api/v1/ops/audit-log | Audit log aktivitas |
| GET | /api/v1/ops/health | Health check endpoint |
Global Error Codes
Error codes yang berlaku untuk semua API group. Format response error:
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": {
"email": ["Invalid email format"],
"name": ["Required field"]
},
"requestId": "req_abc123"
}
}| Code | HTTP Status | Deskripsi |
|---|---|---|
UNAUTHORIZED | 401 | Token/API key tidak valid atau sudah expired |
FORBIDDEN | 403 | Tidak memiliki izin untuk mengakses resource |
NOT_FOUND | 404 | Resource yang diminta tidak ditemukan |
VALIDATION_ERROR | 400 | Request body atau parameter tidak valid |
RATE_LIMITED | 429 | Batas rate limit tercapai — coba lagi setelah retry-after |
INTERNAL_ERROR | 500 | Server error — hubungi support jika persisten |
SERVICE_UNAVAILABLE | 503 | Layanan sedang maintenance atau overloaded |
CONFLICT | 409 | Konflik state — operasi tidak bisa dilakukan saat ini |
SDKs & Client Libraries
Gunakan official SDK untuk integrasi yang lebih mudah.
Node.js / TypeScript
npm install @conai/sdkPython
pip install conai-sdkGo
go get conai.id/sdk/goAPI Versioning
Semua endpoint menggunakan versi URL (/api/v1/). Perubahan breaking akan diumumkan minimal 90 hari sebelumnya melalui Changelog dan email. Endpoint deprecated akan tetap berfungsi selama 6 bulan setelah pengumuman.