Developer

Autentikasi

Semua permintaan Public API dan MCP memakai satu mekanisme: API key sebagai Bearer token.

Sebelum mulai

Anda sudah memiliki API key. Lihat API Key dan Scope.

Mengirim key

Kirim key di header Authorization pada setiap permintaan.

Code
curl -H "Authorization: Bearer <api-key>" \
  https://<domain-anda>/api/v1/public/health

Alamat dasar Public API adalah https://<domain-anda>/api/v1/public. Gunakan HTTPS.

Format key

Key diawali ${API_KEY_PREFIX}_live_, dengan API_KEY_PREFIX adalah awalan merek deployment Anda. Awalan yang ditampilkan di kolom "Key Prefix" tabel key adalah awalan yang benar.

Menguji key

GET /api/v1/public/health menjawab untuk key valid apa pun dan tidak butuh scope. Jawaban 200 berarti key berfungsi. 401 berarti masalah ada pada key, bukan pada permintaan Anda.

Dokumentasi dari server

Server menyediakan dokumen yang selalu sesuai dengan yang berjalan. Semuanya butuh key valid tetapi tidak butuh scope.

GET /api/v1/public/openapi.json untuk spesifikasi OpenAPI.
GET /api/v1/public/agent-guide.md untuk panduan bagi agen AI, disaring sesuai scope key (tambahkan ?scope=all untuk semuanya).

Daftar endpoint lengkap ada di API Reference.

Hasil yang diharapkan

Panggilan health mengembalikan 200.

Masalah umum

401 Unauthorized: header tidak ada, formatnya bukan Bearer <api-key>, key kosong, atau key tidak valid, dicabut, atau kedaluwarsa.
429 setelah banyak percobaan gagal: terlalu banyak autentikasi gagal dari satu alamat IP membuat alamat itu diblokir sementara. Tunggu sesuai Retry-After.
Key bocor? Cabut segera di Pengembang > API Keys.

Lanjut ke Rate Limit dan Error.

Last modified on October 9, 2026

API Key dan Scope Rate Limit dan Error