Autenticacion

Header requerido

Cada request al motor debe incluir el header x-api-key:

POST /api/v1/exercises/evaluate HTTP/1.1
Host: api.disnomia.econdor.com
Content-Type: application/json
x-api-key: pi_com_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Formato de las API keys

Tier	Prefijo	Ejemplo
Internal (eCondor)	`pi_int_`	`pi_int_3a7f9c...`
Trial	`pi_tri_`	`pi_tri_8b2e1d...`
Commercial	`pi_com_`	`pi_com_5c4a9f...`

El prefijo identifica el tier a simple vista en tus logs sin exponer la key completa.

Obtener una API key

Clientes nuevos:

Contacta a eCondor Digital
Elige un plan (Trial, Starter, Pro)
Recibe tu API key por email

Desarrolladores internos de eCondor:

CONVEX_HTTP_URL=https://xxx.convex.cloud \
CONVEX_ADMIN_KEY=prod:xxx \
ts-node scripts/nueva-key.ts internal "Nombre - eCondor"

Guardar la key de forma segura

Nunca incluyas la key directamente en el codigo fuente
Usa variables de entorno: ENGINE_API_KEY=pi_com_xxx
En produccion, usa un gestor de secretos (AWS Secrets Manager, Doppler, etc.)

Errores de autenticacion

Codigo	Descripcion
`401`	API key faltante o invalida
`403`	Licencia vencida o limite mensual alcanzado
`429`	Rate limit excedido (ver Limites)