Getting started
Authentication
Use your API key safely.
Every ChatKazi API request needs an API key.
Create API keys from your ChatKazi dashboard. An API key can only access the WhatsApp sessions connected to your account.
Keep API keys on your backend. Do not put them in browser JavaScript, mobile apps, GitHub, or public documentation.
Base URL
Use ChatKazi API base URL plus the /api/v1 prefix.
https://chatkazi.locci.cloud/api/v1
Send the API key
You can authenticate with either x-api-key:
Terminal
curl "$CHATKAZI_BASE_URL/sessions" \
-H "x-api-key: $CHATKAZI_API_KEY"
Or with a Bearer token:
Terminal
curl "$CHATKAZI_BASE_URL/sessions" \
-H "Authorization: Bearer $CHATKAZI_API_KEY"
Set backend variables
.env
CHATKAZI_BASE_URL=https://chatkazi.locci.cloud/api/v1
CHATKAZI_API_KEY=ck_live_your_api_key
Node.js helper
chatkazi.js
const CHATKAZI_BASE_URL = process.env.CHATKAZI_BASE_URL
const CHATKAZI_API_KEY = process.env.CHATKAZI_API_KEY
export async function chatkazi(path, options = {}) {
const response = await fetch(`${CHATKAZI_BASE_URL}${path}`, {
...options,
headers: {
'Content-Type': 'application/json',
'x-api-key': CHATKAZI_API_KEY,
...options.headers
}
})
const payload = await response.json()
if (!response.ok) {
throw new Error(payload.message || 'ChatKazi request failed')
}
return payload
}