API Key Yönetimi

API Key yönetim uç noktaları yalnızca JWT kimlik doğrulamasını kabul eder.

Yarat API Key

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

İstek parametreleri:

Parametre	Tip	Gerekli	Tanım
`label`	string	Evet	API Key etiketi, uzunluğu 1 - 64
`permissions`	int	Hayır	İzin bitmaskesi, varsayılan `1`, aralık `1` - `7`
`ipWhitelist`	String[]	Hayır	IP beyaz liste, 20’ye kadar giriş. Eğer hariç tutulursa, kaynak IP sınırsızdır

Örnek istemek:

$ 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"]
>   }'

Yanıt örneği:

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

apiSecret API Key oluşturulduğunda sadece bir kez geri döner. Hemen gizli bir yönetim sisteminde depolayın. Bunu kaynak kod depolarına veya loglara yazmayın.

Her kullanıcı 30 API Anahtar oluşturabilir.

Liste API Anahtarlar

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

Yanıt alanları:

Saha	Tip	Tanım
`list[].id`	string	API Key Kimliği
`list[].label`	string	Plak Şirketi
`list[].apiKey`	string	Kamu API Key tanımlayıcısı
`list[].permissions`	int	Permission bitmask
`list[].ipWhitelist`	String[]	IP beyaz listesi
`list[].status`	int	Durum: `1` etkin, `0` devre dışı bırakıldı
`list[].lastUsedAt`	int64	Son kullanım zamanı
`list[].createdAt`	int64	Yaratım zamanı

Güncelleme API Key

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

İstek parametreleri:

Parametre	Tip	Gerekli	Tanım
`id`	string	Evet	API Key Kimliği
`label`	string	Hayır	Yeni plak şirketi
`permissions`	int	Hayır	Yeni izin bitmaskesi
`ipWhitelist`	String[]	Hayır	Yeni IP beyaz listesi
`status`	int	Hayır	`1` etkinleştirildi, `0` devre dışı bırakıldı

Sil API Key

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

Talep bedeni:

1 { "id": "1001" }

Tüm API Anahtarlarını Sil

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