Manajemen API Key

Endpoint manajemen API Key hanya menerima autentikasi JWT.

Buat API Key

1 POST /v1/private/user/api-key/create
2 Authorization: Bearer YOUR_ACCESS_TOKEN
3 Content-Type: application/json

Parameter permintaan:

Parameter	Tipe	Wajib	Deskripsi
`label`	string	Ya	API Key label, panjang 1 - 64
`permissions`	int	Tidak	Bitmask izin, `1`default, rentang `1` - `7`
`ipWhitelist`	senar[]	Tidak	IP daftar putih, hingga 20 entri. Jika dihilangkan, IP sumber tidak dibatasi

Contoh permintaan:

$ curl -X POST https://api.6mm.com/v1/private/user/api-key/create \
>   -H "Content-Type: application/json" \
>   -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
>   -d '{
>     "label": "external-service-prod",
>     "permissions": 3,
>     "ipWhitelist": ["203.0.113.10"]
>   }'

Contoh respons:

1 {
2   "code": 0,
3   "message": "success",
4   "data": {
5     "apiKey": "fx_xxxxxxxxxxxxxxxxxxxxxxxx",
6     "apiSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
7   },
8   "requestId": "req-api-key"
9 }

apiSecret hanya dikembalikan sekali saat API Key dibuat. Simpan segera dalam sistem manajemen rahasia. Jangan menuliskannya ke repositori kode sumber atau log.

Setiap pengguna dapat membuat hingga 30 API Key.

Daftar Kunci API

1 GET /v1/private/user/api-key/list
2 Authorization: Bearer YOUR_ACCESS_TOKEN

Bidang respons:

Lapangan	Tipe	Deskripsi
`list[].id`	string	ID API Key
`list[].label`	string	Label
`list[].apiKey`	string	Pengidentifikasi API Key publik
`list[].permissions`	int	Bitmask izin
`list[].ipWhitelist`	senar[]	IP daftar putih
`list[].status`	int	Status: `1` diaktifkan, `0` dinonaktifkan
`list[].lastUsedAt`	int64	Waktu terakhir digunakan
`list[].createdAt`	int64	Waktu penciptaan

Pembaruan API Key

1 PUT /v1/private/user/api-key/update
2 Authorization: Bearer YOUR_ACCESS_TOKEN
3 Content-Type: application/json

Parameter permintaan:

Parameter	Tipe	Wajib	Deskripsi
`id`	string	Ya	ID API Key
`label`	string	Tidak	Label baru
`permissions`	int	Tidak	Bitmask izin baru
`ipWhitelist`	senar[]	Tidak	Daftar putih IP baru
`status`	int	Tidak	`1` diaktifkan, `0` dinonaktifkan

Hapus API Key

1 POST /v1/private/user/api-key/delete
2 Authorization: Bearer YOUR_ACCESS_TOKEN
3 Content-Type: application/json

Badan permintaan:

1 { "id": "1001" }

Hapus Semua Kunci API

1 POST /v1/private/user/api-key/delete-all
2 Authorization: Bearer YOUR_ACCESS_TOKEN
3 Content-Type: application/json