Zum Hauptinhalt springen

Crear nueva API Key

POST 

/apikey/

Crea una nueva API Key para el usuario autenticado asociada a su compañía.

Flujo de operación:

  1. Valida que el usuario exista y pertenezca a una compañía
  2. Verifica que no se haya excedido el límite máximo de API Keys por compañía
  3. Genera una clave única con prefijo según entorno (sk_test_ o sk_live_)
  4. Crea un código temporal para operaciones de gestión
  5. Almacena la clave en la base de datos

Consideraciones importantes:

  • La API Key solo se muestra completa en el momento de creación
  • No se puede recuperar posteriormente, debe almacenarse de forma segura
  • Cada compañía tiene un límite máximo de claves permitidas
  • Requiere autenticación JWT válida

Ejemplo de Request:

{
"type": "write"
}

Posibles errores:

  • 400: Solicitud inválida (tipo no especificado)
  • 401: No autenticado
  • 403: Límite de claves alcanzado
  • 404: Usuario o compañía no encontrados

Request

Responses

Successful operation