API Key Управління

API Key кінцеві точки управління приймають лише JWT автентифікацію.

Створіть API Key

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

Параметри запиту:

Параметр	Тип	Обов’язкове	Опис
`label`	string	Так	API Key етикетка, довжина 1 - 64
`permissions`	int	Ні	Бітова маска дозволу, стандартний `1`, діапазон `1` - `7`
`ipWhitelist`	String[]	Ні	IP білий список, до 20 записів. Якщо його опускати, IP джерела є необмеженим

Приклад запиту:

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

Приклад відповіді:

{
  "code": 0,
  "message": "success",
  "data": {
    "apiKey": "fx_xxxxxxxxxxxxxxxxxxxxxxxx",
    "apiSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "requestId": "req-api-key"
}

apiSecret повертається лише один раз після створення API Key . Зберігайте його одразу в секретній системі управління. Не записуйте це у репозиторії чи логи вихідного коду.

Кожен користувач може створити до 30 API Keys.

Список API ключів

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

Поля відповіді:

Поле	Тип	Опис
`list[].id`	string	API Key ID
`list[].label`	string	Лейбл
`list[].apiKey`	string	Публічний ідентифікатор API Key
`list[].permissions`	int	Бітмаска дозволу
`list[].ipWhitelist`	String[]	IP білий список
`list[].status`	int	Статус: `1` увімкнено, `0` вимкнено
`list[].lastUsedAt`	int64	Останній час використання
`list[].createdAt`	int64	Час створення

Оновлення API Key

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

Параметри запиту:

Параметр	Тип	Обов’язкове	Опис
`id`	string	Так	API Key ID
`label`	string	Ні	Новий лейбл
`permissions`	int	Ні	Нова бітова маска дозволу
`ipWhitelist`	String[]	Ні	Новий білий список IP
`status`	int	Ні	`1` увімкнено, `0` вимкнено

Видалити API Key

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

Тіло запиту:

{ "id": "1001" }

Видалити всі API ключі

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