La API de AVALA
Una API REST para equipos que quieren integrar el Sistema Nacional de Competencias en sus propios sistemas: datos del RENEC, Rutas de Reinvención y verificación de credenciales, desde el mismo backend que sirve a la plataforma AVALA.
Qué cubre la API hoy
Cuatro superficies en producción. Las públicas no requieren autenticación; las privadas usan Bearer JWT.
Datos públicos del RENEC
Consulta el Registro Nacional de Estándares de Competencia sin autenticación: Estándares de Competencia (EC), entidades certificadoras y centros de evaluación, con búsqueda unificada y estadísticas de frescura de datos. Limitado a 30 solicitudes por minuto.
GET /v1/renec/ec-standardsGET /v1/renec/ec-standards/:ecClaveGET /v1/renec/certificadoresGET /v1/renec/centrosGET /v1/renec/searchGET /v1/renec/statsRutas de Reinvención
El mismo endpoint público que alimenta las Rutas de Crecimiento del sitio: categorías de reinvención con sus Estándares de Competencia asociados, horas estimadas y plataformas de continuidad. Sin autenticación.
GET /v1/ec/reinvention-pathsVerificación pública de credenciales
Verifica una credencial de preparación (Open Badges 3.0 / W3C Verifiable Credentials) o un certificado de finalización sin crear cuenta: estado, logro, emisor y revocación vía W3C Bitstring Status List.
GET /v1/credentials/verify/:idGET /v1/credentials/status-list/:tenantIdGET /v1/certificates/public/:uuidSuperficies privadas con JWT
Formación, inscripciones, portafolios de evidencia, emisión de credenciales y cumplimiento (DC-3) operan tras autenticación Bearer JWT emitida por Janua, la capa de identidad del ecosistema MADFAM. Estas superficies son multi-tenant y se habilitan por organización.
Authorization: Bearer <token>Un ejemplo real, sin llave de API
Las Rutas de Reinvención que ves en este sitio salen de este endpoint público. Pruébalo desde tu terminal.
Solicitud
GET https://api.avala.studio/v1/ec/reinvention-pathsRespuesta 200 (fragmento ilustrativo con el contrato real)
{
"categories": [
{
"category": "Linguistic Intermediation",
"isAiProof": false,
"platforms": ["polygloss.ai"],
"standards": [
{
"code": "EC1263",
"title": "Traducción de textos literarios y humanísticos al español",
"estimatedHours": 14,
"available": false
}
]
}
]
}Los valores provienen del catálogo vivo. El campo available refleja el estado editorial real de cada Estándar de Competencia: hoy nuestro catálogo está en revisión por especialistas (SME), por lo que verás false hasta que cada contenido sea aprobado.
Cómo está construida
30 módulos de dominio
La API está construida en NestJS y organizada en 30 módulos: RENEC, competencias, cursos, evaluaciones, portafolios, credenciales, cumplimiento, facturación y más. Todas las rutas viven bajo el prefijo /v1.
Contratos OpenAPI
Cada controlador está anotado con decoradores OpenAPI (Swagger) que describen operaciones, parámetros y respuestas. Esa misma fuente alimentará la referencia pública de la API.
Acceso por plan
El acceso a la API (api_access) está incluido a partir del plan Institución. El plan Enterprise agrega SSO SAML, aprovisionamiento SCIM y soporte dedicado.
La referencia pública está en preparación
Los contratos OpenAPI ya existen en el código, pero todavía no publicamos una referencia navegable de la API. Los endpoints públicos de esta página funcionan hoy; para integrar las superficies privadas, solicita acceso anticipado y te contactamos para revisar tu caso de uso. Sin compromiso de compra.