Skip to main content

​
Gambaran Umum

CSKU AI Public API menggunakan autentikasi Bearer Token dengan Secret Key.
Catatan Keamanan: Jangan pernah mengekspos Secret Key Anda di kode sisi klien. Selalu lakukan panggilan API dari lingkungan server yang aman.

​
Mendapatkan Secret Key

1

Login ke Dashboard

Buka app.csku.ai dan login ke akun Anda
2

Buka Secret Key Settings

Navigasi ke Settings → Secret Key Settings
3

Salin Secret Key

Salin Secret Key Anda

Dapatkan Secret Key

Buka halaman Secret Key Settings untuk mendapatkan kredensial Anda

​
Format Autentikasi

Gunakan header Authorization dengan Bearer token: 
Authorization: Bearer {secret_key}

​
Contoh Penggunaan

curl -X POST "https://api.csku.ai/v1/message" \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "conv_123456",
    "text": "Halo, saya butuh bantuan"
  }'

​
Praktik Keamanan Terbaik

  1. Jangan Pernah Mengekspos Secret Key
    • Simpan di variabel lingkungan (environment variables)
    • Gunakan layanan manajemen rahasia (AWS Secrets Manager, Azure Key Vault, dll.)
    • Jangan pernah commit ke version control
  2. Gunakan HTTPS
    • Selalu gunakan HTTPS untuk semua permintaan API
    • Jangan pernah kirim kredensial melalui HTTP
  3. Rotasi Kredensial
    • Ubah secret key secara periodik
    • Segera ganti jika ada kebocoran

​
Respons Error Autentikasi

Jika autentikasi gagal, Anda akan menerima respons error: 
{
  "status": 0,
  "rc": 401,
  "error_msg": "Data tidak valid. Mohon periksa kembali parameter dan header"
}

​
Penyebab Error Umum

MasalahSolusi
Header Authorization tidak adaTambahkan header Authorization: Bearer {secret_key}
Secret Key tidak validPeriksa kembali Secret Key dari dashboard
Format header salahPastikan format: Bearer {secret_key} (dengan spasi setelah Bearer)

​
Batas Rate

API menerapkan pembatasan rate:
  • 100 permintaan per menit untuk permintaan terautentikasi
Ketika melebihi batas: 
{
  "status": 0,
  "rc": 429,
  "error_msg": "Terlalu banyak permintaan. Silakan coba lagi nanti."
}
Implementasikan exponential backoff untuk menangani batas rate dengan baik.