AARPIA Lite — API

Motor FSM declarativo VOE. Toda entidad gobierna su FSM. Todo recurso es instancia de una entidad del catálogo §7.

Entry points

• /api/v1/canonico — catálogo navegable (Plano 1, API VOE)
• /api/v1/docs — Swagger UI + OpenAPI 3.1 derivado
• /api/v1/health — health check
• POST /api/v1/auth/login — autenticación (body: { email, password } o { agent_id, credencial })

Naming canónico §7

AARPIA.<subdominio>.<token>.<estado_deseable>

9 subdominios: infra, auth, registros, integracion, ia, gobernanza, claves, sistema, maestros.

URL canónica

/api/v1/canonico/<sub>/<token>/<estado>/v<MAJOR>.<MINOR>/...

Para agentes IA

Solicita JSON:API con cabecera Accept: application/json o application/vnd.api+json. La respuesta incluye data, links, relationships y meta.acciones_disponibles.

curl -H "Accept: application/json" http://localhost:3000/

Doctrina viva: SYSTEM_LITE §33 — API canónica y separación de planos exógenos. Diseño completo en docs/bloque-api-canonica/.