API Key Gestione | 6MM Docs

API Key endpoint di gestione accettano solo JWT autenticazione.

Crea API Key

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

Parametri della richiesta:

Parametro	Tipo	Richiesto	Descrizione
`label`	string	Sì	API Key etichetta, lunghezza 1 - 64
`permissions`	int	No	Permesso bitmaschera, `1`predefinito, intervallo `1` - `7`
`ipWhitelist`	string[]	No	IP whitelist, fino a 20 voci. Se omesso, il IP di sorgente è senza restrizioni

Esempio di richiesta:

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

Esempio di risposta:

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

apiSecret viene restituito una sola volta quando il API Key viene creato. Memorizzalo immediatamente in un sistema di gestione segreto. Non scriverlo in repository o log del codice sorgente.

Ogni utente può creare fino a 30 chiavi API .

Elenco API Chiavi

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

Campi di risposta:

Campo	Tipo	Descrizione
`list[].id`	string	API Key ID
`list[].label`	string	Etichetta
`list[].apiKey`	string	Identificatore pubblico API Key
`list[].permissions`	int	Bitmask di permesso
`list[].ipWhitelist`	string[]	IP whitelist
`list[].status`	int	Stato: `1` abilitato, `0` disabilitato
`list[].lastUsedAt`	int64	Ultimo tempo utilizzato
`list[].createdAt`	int64	Tempo di creazione

Aggiornamento API Key

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

Parametri della richiesta:

Parametro	Tipo	Richiesto	Descrizione
`id`	string	Sì	API Key ID
`label`	string	No	Nuova etichetta
`permissions`	int	No	Nuova bitmask di permesso
`ipWhitelist`	string[]	No	Whitelist dei nuovi IP
`status`	int	No	`1` abilitato `0` disabilitato

Elimina API Key

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

Corpo della richiesta:

{ "id": "1001" }

Elimina tutte le API chiavi

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