Todos los endpoints de la API de DeepXL requieren autenticación. Puedes autenticarte usando una clave de API o un token Bearer (JWT de Clerk).
Autenticación con clave de API
Pasa tu clave de API en el encabezado x-api-key:
curl https://api.deepxl.ai/v1/detection \
-H "x-api-key: YOUR_API_KEY"
Gestión de claves de API
Usa los endpoints de claves de API para gestionar tus claves de forma programática:
| Acción | Método | Endpoint |
|---|
| Listar claves | GET | /v1/api-keys |
| Crear clave | POST | /v1/api-keys |
| Actualizar clave | PUT | /v1/api-keys/{id} |
| Eliminar clave | DELETE | /v1/api-keys/{id} |
Los endpoints de gestión de claves de API requieren autenticación mediante token Bearer (JWT de Clerk). No puedes gestionar claves de API usando otra clave de API.
Autenticación con token Bearer
Pasa un JWT de Clerk en el encabezado Authorization:
curl https://api.deepxl.ai/v1/detection \
-H "Authorization: Bearer YOUR_CLERK_JWT"
Autenticación dual
Todos los endpoints de análisis (/v1/detection, /v1/parse, /v1/verification, /v1/files) aceptan o bien una clave de API o bien un token Bearer. Si se proporcionan ambos, el token Bearer tiene prioridad.
Respuestas de error
| Estado | Descripción |
|---|
401 Unauthorized | Falta la clave de API / token Bearer, o no es válido |
403 Forbidden | Credenciales válidas pero permisos insuficientes |
{
"statusCode": 401,
"error": "Unauthorized",
"message": "Unauthorized"
}
