Management API Keys

Management API Key mengelola proyek, anggaran, dan kunci API model serta memeriksa penggunaan proyek dan kunci di seluruh akun tim.

Management API Key mengelola proyek, anggaran, dan kunci API model serta memeriksa penggunaan proyek dan kunci di seluruh akun tim.

Kunci mana yang diterima setiap endpoint?

Perbandingan ini mencakup kunci API. Token OAuth dengan scope tetap didukung untuk kueri penagihan jika fitur tersebut diaktifkan.

Membuat kunci pengelolaan

  1. Masuk ke Console dan pilih akun tim tempat Anda menjadi Owner.
  2. Buka Developer → Management API Keys di bilah samping, atau langsung ke halaman ini. Menu ini hanya terlihat oleh Owner tim saat ini.
  3. Isi Name, atur Expires (optional) bila perlu, lalu klik Create key.
  4. Klik Copy key dan simpan kunci mgmt-... baru sebagai ATLASCLOUD_MANAGEMENT_API_KEY untuk contoh berikut. Rahasia hanya ditampilkan sekali.

Dari mana api_key_id diperoleh?

api_key_id dalam URL adalah kolom id berformat ak_... dari respons Buat kunci API model (POST /public/v1/api-keys). Simpan nilainya untuk menonaktifkan atau menghapus kunci, mengatur batas, dan memeriksa penggunaan. Kolom key (apikey-...) digunakan untuk panggilan model; panggilan pengelolaan tetap memakai mgmt-... pada header otorisasi.

Contohnya, respons pembuatan berisi kolom berikut:

{
  "id": "ak_0123456789ABCDEFGHIJKL",
  "key": "apikey-REPLACE_WITH_SECRET_RETURNED_ONCE"
}

Gunakan id yang sama pada jalur, misalnya /public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage. API_KEY_ID dalam contoh berarti nilai ini. Public API saat ini tidak menyediakan daftar kunci, jadi simpan id saat membuat kunci.

Memanggil Public API

Kirim kunci pengelolaan melalui header Authorization: Bearer. Permintaan menggunakan akun Team yang terkait dengan kunci tersebut.

curl -X POST "https://api.atlascloud.ai/public/v1/projects" \
  -H "Authorization: Bearer $ATLASCLOUD_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"customer-123"}'

Panduan langkah demi langkah (Inggris).

Mengelola kunci

Kunci pengelolaan yang dinonaktifkan, dihapus, atau kedaluwarsa tidak dapat digunakan untuk autentikasi. Anda dapat mengaktifkan atau menonaktifkan kunci yang belum kedaluwarsa di halaman pengelolaan. Penghapusan tidak dapat dibatalkan.

Kunci dimiliki oleh tim dan tetap berlaku saat pembuatnya keluar dari tim atau tidak lagi menjadi Owner. Owner saat ini dapat mengelola kunci dari Owner sebelumnya. Nonaktifkan atau hapus kunci untuk mencabut akses.

Setiap tim dapat menyimpan maksimal 5 kunci pengelolaan yang belum dihapus, termasuk yang dinonaktifkan dan kedaluwarsa. Menghapus kunci akan menyediakan satu slot.

Last updated on

On this page