API Key Gestión | 6MM Docs

API Key endpoints de gestión solo aceptan autenticación JWT .

Crea API Key

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

Parámetros de la solicitud:

Parámetro	Tipo	Obligatorio	Descripción
`label`	string	Sí	API Key etiqueta, longitud 1 - 64
`permissions`	int	No	Máscara de permisos, `1`por defecto, rango `1` - `7`
`ipWhitelist`	cuerda[]	No	IP lista blanca, hasta 20 entradas. Si se omite, el IP fuente no tiene restricciones

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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

apiSecret solo se devuelve una vez cuando se crea el API Key . Guárdalo inmediatamente en un sistema de gestión secreto. No lo escribas en repositorios o registros del código fuente.

Cada usuario puede crear hasta 30 API Keys.

Lista API Claves

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

Campos de respuesta:

Campo	Tipo	Descripción
`list[].id`	string	API Key ID
`list[].label`	string	Sello
`list[].apiKey`	string	Identificador público de API Key
`list[].permissions`	int	Máscara de bits de permiso
`list[].ipWhitelist`	cuerda[]	IP lista blanca
`list[].status`	int	Estado: `1` activado, `0` deshabilitado
`list[].lastUsedAt`	int64	Último tiempo utilizado
`list[].createdAt`	int64	Época de creación

Actualización API Key

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

Parámetros de la solicitud:

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	API Key ID
`label`	string	No	Nueva discográfica
`permissions`	int	No	Nueva máscara de permiso
`ipWhitelist`	cuerda[]	No	Lista blanca de nuevos IP
`status`	int	No	`1` activado `0` deshabilitado

Elimina API Key

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

Cuerpo de la solicitud:

1 { "id": "1001" }

Eliminar todas API claves

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