Saltar al contenido principal

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