Referensi API

API Kloosr adalah antarmuka programatik ke setiap lapisan platform: data bisnis, event integrasi, trigger workflow, dan agent AI. REST-first dengan GraphQL untuk query kompleks, versioned di bawah /v1, dan dirancang dengan model tata kelola yang sama dengan tim operasional di console.

Semua endpoint membutuhkan OAuth 2.0 client credentials atau API key scoped. Request terisolasi per tenant, rate-limited per paket, dan tercatat penuh di audit trail. Environment sandbox dan produksi adalah tenant terpisah dengan permukaan API identik.

Versi API saat ini

99,9%

API uptime SLA

120

Request/detik (Scale)

<200ms

Latensi P95

Domain API

Core & Auth

/v1/auth, /v1/tenants

Token exchange, metadata tenant, user provisioning, dan manajemen peran.

POST /oauth/tokenGET /tenants/{id}GET /usersPOST /users

Business Data

/v1/crm, /v1/inventory, /v1/finance

Operasi CRUD pada order, SKU, pelanggan, invoice, dan entri ledger.

GET /inventory/itemsPOST /crm/dealsPATCH /finance/invoices/{id}

Integrations

/v1/connectors, /v1/sync

Kelola connector, trigger sync job, inspeksi field mapping, dan replay event gagal.

GET /connectorsPOST /sync/triggerGET /sync/logs

Workflows & Events

/v1/workflows, /v1/events

Subscribe event bus, publish event custom, dan invoke workflow automation.

POST /events/subscribeGET /events/{id}POST /workflows/{id}/run

AI & Copilot

/v1/ai

Query data operasional dalam bahasa natural, jalankan ekstraksi dokumen, dan invoke agent tasks.

POST /ai/queryPOST /ai/documents/extractPOST /ai/agents/run

Contoh Kode

Autentikasi

POST /v1/oauth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "kl_live_xxxxxxxx",
  "client_secret": "sk_live_xxxxxxxx",
  "scope": "inventory:read crm:write"
}

// Response
{
  "access_token": "eyJhbG...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "inventory:read crm:write"
}

Query Inventori

GET /v1/inventory/items?reorder_below=true&warehouse_id=wh_jkt_01
Authorization: Bearer eyJhbG...
X-Kloosr-Tenant: tenant_acme

{
  "data": [
    {
      "id": "sku_1042",
      "name": "Hydraulic Seal 42mm",
      "quantity_on_hand": 18,
      "reorder_point": 50,
      "warehouse_id": "wh_jkt_01",
      "last_synced_at": "2026-08-10T08:14:22Z"
    }
  ],
  "meta": { "total": 3, "page": 1, "per_page": 25 }
}

SDK Resmi

JavaScript / TypeScript

v3.2.1

npm install @kloosr/sdk

Python

v2.8.0

pip install kloosr

Java

v1.6.0

Maven: com.kloosr:sdk:1.6.0

v1.4.2

go get github.com/kloosr/kloosr-go

Rate Limit per Paket

Launch

30 req/s

60/min

Growth

60 req/s

120/min

Scale

120 req/s

300/min

Enterprise

Custom

Dedicated pool

Webhook

inventory.stock.low

Dipicu saat kuantitas SKU turun di bawah reorder point.

order.created

Sales atau purchase order baru dibuat di channel terhubung mana pun.

sync.failed

Sync job connector gagal setelah kebijakan retry habis.

workflow.completed

Workflow automation selesai sukses atau dengan error terminal.

ai.query.completed

Query Copilot mengembalikan respons terstruktur.