Autentikasi

Reigniter API menggunakan kunci API. Setiap kunci dimiliki oleh satu akun dan bertindak sebagai akun tersebut: ia menghabiskan kredit akun tersebut dan hanya melihat pekerjaan akun tersebut.

Buat kunci

API kunci adalah bagian dari rencana Agency.

Masuk ke Reigniter.
Buka kunci > API akun (/app/account/api-keys).
Di bawah Buat kunci baru, ketik label yang akan Anda kenali nanti, seperti CI pipeline atau CMS sync.
Pilih Buat.
Salin kunci segera.

Kuncinya seperti ini: emp_ diikuti oleh 64 karakter heksadesimal.

Kirim kuncinya

Masukkan kunci di header Authorization sebagai token Bearer pada setiap permintaan:

curl https://reigniter.ai/v1/me \
  -H "Authorization: Bearer $REIGNITER_API_KEY"

Kunci yang valid akan mengembalikan 200 bersama akun Anda:

{
  "user_id": "3f1c2a9e-8b7d-4c1e-9f0a-2d6b5e4c3a21",
  "email": "dev@example.com",
  "name": "Sam",
  "credits_remaining": 42
}

Ketika sebuah kunci ditolak

Status	`code`	Makna
`401`	`NO_API_KEY`	Tidak ada header `Authorization`, atau token tidak dimulai dengan `emp_`.
`401`	`INVALID_API_KEY`	Kunci tersebut tidak diketahui atau telah dicabut.
`402`	`PLAN_UPGRADE_REQUIRED`	Kuncinya valid, tapi akun tersebut tidak ada di paket Agency.
`403`	`ACCOUNT_SUSPENDED`	Akun yang memiliki kunci tersebut akan ditangguhkan.

Jika sebuah akun keluar dari paket Agency, kuncinya berhenti berfungsi sampai kembali ke Agency.

Rahasiakan kunci

Simpan kunci di secret manager atau variabel lingkungan. Jangan pernah mengkomitmenkannya ke source control.
Hubungi API hanya dari server Anda. Jangan pernah mengirim kunci di halaman web atau aplikasi seluler. Permintaan browser ke API tidak diperbolehkan oleh kebijakan CORS-nya.
Gunakan satu kunci per sistem, dengan label yang jelas. Kemudian Anda bisa mencabut satu kunci tanpa merusak yang lain.
Layar tombol API menunjukkan kapan setiap kunci terakhir digunakan. Kunci yang tidak Anda kenali, atau yang digunakan saat seharusnya tidak, harus dicabut.

Cabut kunci

Buka kunci > API akun.
Di bawah tombol Aktif, temukan kunci berdasarkan labelnya.
Pilih ikon Cabut kunci (bin).

Kunci yang dicabut langsung ditolak dengan 401 INVALID_API_KEY. Pencabutan tidak dapat dibatalkan. Render yang sudah dimulai dengan kunci terus berjalan.