Api key Cliente

Crear API Keys

POST /v1/api-keys

Este endpoint permite crear una api key para un cliente determinado.

¿Es la primera vez que generas una API Key? En ese caso, deberás incluir el siguiente header en tu solicitud.

Authorization: Bearer example_access_token_cliente

¿Ya tienes una API Key disponible? Entonces puedes hacer la solicitud incluyendo el siguiente header.

X-Api-Key: api_key_cliente
ParámetrosDescripción
user
  • string
  • Email del cliente. Debe estar en minúsculas: las mayúsculas se rechazan con 400
customer_id
  • (opcional)
  • string
  • Identificador del cliente.
country
  • (opcional)
  • string
  • País del cliente (por ejemplo ARG).
ℹ️
  • Si no existe un usuario para ese email, se crea uno de servicio de forma automática. Si el usuario está deshabilitado, la solicitud responde 422.
  • Solo se cuentan las API Keys en estado ENABLED: el máximo es 10 por usuario y, al superarlo, la solicitud responde 422.
  • El valor completo de api_key solo se devuelve en esta respuesta (201). El listado lo devuelve enmascarado.
  • Pueden ocurrir además errores 400 de validación del body.
curl --request POST \
  --url https://api.menta.global/api/v1/api-keys \
  --header 'X-Api-Key: api_key_cliente' \
  --data '{
    "user": "email_cliente",
    "customer_id": "{id_cliente}"
  }'
  {
      "id": "string",
      "api_key": "string",
      "user": "string",
      "user_type": "CUSTOMER",
      "customer_id": "string",
      "status": "ENABLED",
      "create_date": "2025-05-27T15:18:14.198056093Z",
      "update_date": "2025-05-27T15:18:14.205319483Z"
  }
AutenticaciónGestión para comercio