Autentikasi

Semua API api.co.id diautentikasi dengan API key yang dikirim lewat header x-api-co-id.

Header x-api-co-id

Sertakan header berikut di setiap request. Tanpa header ini, server mengembalikan 401.

API key Anda

Disimpan hanya di browser ini dan dipakai oleh fitur Coba langsung.

Request terautentikasi

curl -X GET "https://use.api.co.id/regional/indonesia/provinces" \  -H "x-api-co-id: $API_CO_ID_KEY"

Chat API

Chat API memakai API key tersendiri yang dikirim sebagai Authorization: Bearer <key>. Lihat Chat API › Getting Started.

Menyimpan API key dengan aman

Rahasiakan API key Anda

Panggil api.co.id dari server Anda, bukan dari kode frontend atau aplikasi mobile. Simpan key di variabel lingkungan dan rotasi secara berkala.

Error autentikasi

Status	Arti	Cara memperbaiki
401Unauthorized	API key tidak valid atau tidak dikirim (mis. User not authenticated).	Kirim header x-api-co-id dengan key yang aktif.
402Payment Required	Saldo tidak cukup untuk endpoint berbayar.	Isi saldo di Dashboard, lalu ulangi request.