API Admin memungkinkan Anda untuk mengelola sumber daya organisasi Anda secara terprogram, termasuk anggota organisasi, ruang kerja, dan kunci API. Ini memberikan kontrol terprogram atas tugas-tugas administratif yang biasanya memerlukan konfigurasi manual di Anthropic Console.

API Admin memerlukan akses khusus

API Admin memerlukan kunci API Admin khusus (dimulai dengan sk-ant-admin...) yang berbeda dari kunci API standar. Hanya anggota organisasi dengan peran admin yang dapat menyediakan kunci API Admin melalui Anthropic Console.

Cara kerja API Admin

Ketika Anda menggunakan API Admin:

  1. Anda membuat permintaan menggunakan kunci API Admin Anda di header x-api-key
  2. API memungkinkan Anda mengelola:
    • Anggota organisasi dan peran mereka
    • Undangan anggota organisasi
    • Ruang kerja dan anggotanya
    • Kunci API

Ini berguna untuk:

  • Mengotomatisasi onboarding/offboarding pengguna
  • Mengelola akses ruang kerja secara terprogram
  • Memantau dan mengelola penggunaan kunci API

Peran dan izin organisasi

Ada empat peran tingkat organisasi.

PeranIzin
userDapat menggunakan Workbench
developerDapat menggunakan Workbench dan mengelola kunci API
billingDapat menggunakan Workbench dan mengelola detail penagihan
adminDapat melakukan semua hal di atas, plus mengelola pengguna

Konsep kunci

Anggota Organisasi

Anda dapat melihat daftar anggota organisasi, memperbarui peran anggota, dan menghapus anggota.

Undangan Organisasi

Anda dapat mengundang pengguna ke organisasi dan mengelola undangan tersebut.

Ruang Kerja

Buat dan kelola ruang kerja untuk mengatur sumber daya Anda:

Anggota Ruang Kerja

Kelola akses pengguna ke ruang kerja tertentu:

Kunci API

Pantau dan kelola kunci API:

Praktik terbaik

Untuk menggunakan API Admin secara efektif:

  • Gunakan nama dan deskripsi yang bermakna untuk ruang kerja dan kunci API
  • Terapkan penanganan kesalahan yang tepat untuk operasi yang gagal
  • Audit peran dan izin anggota secara berkala
  • Bersihkan ruang kerja yang tidak digunakan dan undangan yang kedaluwarsa
  • Pantau penggunaan kunci API dan rotasi kunci secara berkala

FAQ