# Key dan autentikasi

Cara kerja key, scope, dan mode live atau test.

Semua permintaan memakai key di header `Authorization`.

```bash
Authorization: Bearer wfb_live_xxxxxxxx
```
## Satu key, satu akun

Satu key membaca satu akun brand. Kalau kamu mengelola beberapa brand, pakai satu key untuk tiap akun.

Key dibuat sendiri di aplikasi Wefluence, lewat **Pengaturan**, lalu **API key**. Beri nama, lalu centang izin yang dibutuhkan.

## Scope

Scope menentukan data yang bisa dibaca sebuah key.

| Scope | Isi | Bawaan |
| --- | --- | --- |
| `campaigns:read` | Daftar kampanye, detail, dan ringkasan konten serta views | Ya |
| `content:read` | Konten dan kreator per kampanye | Ya |
| `finance:read` | Sisa dana, nominal dibayar, biaya layanan, dan tagihan | Tidak |

Tanpa `finance:read`, ringkasan kampanye tetap keluar tanpa blok `money`.

## Live dan test

| Awalan | Membaca |
| --- | --- |
| `wfb_live_` | Akun brand-mu |
| `wfb_test_` | Akun contoh, untuk mencoba tanpa menyentuh data asli |

## Masa berlaku

Key berlaku 12 bulan, dan satu akun bisa punya sampai 5 key aktif. Untuk mengganti key, buat key baru, pindahkan sistemmu, lalu cabut yang lama. Key yang dicabut langsung berhenti bekerja dan tidak bisa dihidupkan lagi.

Baca juga [cara menjaga key tetap aman](https://docs.wefluence.app/guides/key-safety/).
