API Key Gestión

Ver como Markdown

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

Crea API Key

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

Parámetros de la solicitud:

ParámetroTipoObligatorioDescripción
labelstringAPI Key etiqueta, longitud 1 - 64
permissionsintNoMáscara de bits de permisos, 1predeterminado, rango 1 - 7
ipWhitelistcuerda[]NoIP 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:

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

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 Llaves.

Lista API Claves

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

Campos de respuesta:

CampoTipoDescripción
list[].idstringAPI Key ID
list[].labelstringSello
list[].apiKeystringIdentificador público de API Key
list[].permissionsintMáscara de bits de permiso
list[].ipWhitelistcuerda[]IP lista blanca
list[].statusintEstado: 1 activado, 0 deshabilitado
list[].lastUsedAtint64Último tiempo usado
list[].createdAtint64Tiempo de creación

Actualización API Key

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

Parámetros de la solicitud:

ParámetroTipoObligatorioDescripción
idstringAPI Key ID
labelstringNoNueva disquera
permissionsintNoNueva máscara de bits de permiso
ipWhitelistcuerda[]NoLista blanca de nuevos IP
statusintNo1 habilitado 0 deshabilitado

Elimina API Key

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

Cuerpo de la solicitud:

{ "id": "1001" }

Eliminar todas las API teclas

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

Campos de respuesta:

CampoTipoDescripción
deletedint64Número de teclas API eliminadas