Centro de Capacitación en Educación a Distancia de la UNED
Universidad Estatal a Distancia (UNED)
Dirección de Producción de Materiales Didácticos, DPMD
Programa de Producción Electrónica Multimedial, PEM
Version: v2026.06.24
PRODUCCIÓN
Productor académico: Marco Sánchez Mora
Diseño y programación: Deiver Herrera Sánchez
DERECHO DE AUTOR
ADVERTENCIA: Los derechos patrimoniales de la presente obra pertenecen en su totalidad
a la Universidad Estatal a Distancia de Costa Rica (UNED), por lo que está prohibida su
copia o reproducción, comunicación pública, puesta a disposición del público, transmisión,
transformación (incluyendo adaptación y traducción), distribución, alquiler o venta de
ejemplares, realizada por cualquier medio o procedimiento, conocido o por conocerse,
sin el consentimiento previo por escrito del titular de los derechos. Eludir esta prohibición,
o las medidas tecnológicas de protección que contenga la obra, constituye una conducta sancionada
por normas de propiedad intelectual.
Las rutas de aprendizaje corresponden a una secuencia de insignias que representa el progreso de una persona a través de diferentes niveles de conocimiento, habilidades o experiencias. Las rutas de aprendizaje permiten que las insignias pasen de ser reconocimientos aislados a representar trayectorias de aprendizaje o desarrollo de competencias.
Para crear una ruta de aprendizaje, es necesario generar una o varias insignias digitales y luego organizarlas en una secuencia lógica, estableciendo relaciones de dependencia entre ellas. Por ejemplo, se podría crear una ruta de aprendizaje para un curso de Liderazgo y Gestión de Proyectos, la cual incluya insignias para cada módulo o tema, y luego establecer que la obtención de una insignia específica es un requisito para obtener la siguiente insignia en la secuencia. De esta manera, las rutas de aprendizaje permiten a las personas visualizar su progreso y logros a lo largo del tiempo, y también pueden ser utilizadas por los empleadores o instituciones educativas para evaluar las habilidades y competencias de una persona en función de su trayectoria de aprendizaje.
Ejemplo ilustrativo de una ruta de aprendizaje
Introducción a liderazgo
Liderazgo en equipos
Gestión de proyectos
La issuer_api_key necesaria para autenticar las peticiones se obtiene desde el formulario de edición del Emisor correspondiente (botón «Ver API KEY»).
v2 y autentica por encabezado Authorization. Este endpoint no utiliza token CSRF porque está diseñado para consumo externo controlado por issuer_api_key, rate limit y reglas CORS.
Retry-After y campo JSON retry_after.https://insignia.uned.ac.crhttps://*.uned.ac.crNota: la lista CORS es útil para clientes web (navegador). Las apps móviles nativas suelen autenticarse por token y no dependen de CORS.
Especificación de la API:
Authorization con formato Bearer ISSUER_API_KEY.
También se acepta el token en formato plano por compatibilidad.
Este endpoint no requiere token CSRF porque está orientado a integraciones externas autenticadas por API key.
El rate limit actual es de 100 solicitudes por 3600 segundos (aprox. 1 hora(s)) por combinación token + IP.
Si se excede el límite, la API responde HTTP 429 con encabezado Retry-After.
// Codigo JS para ejecutar Adjudicaciones externas desde la API: https://insignia.uned.ac.cr/assertion/api/v2/award
const url = "https://insignia.uned.ac.cr/assertion/api/v2/award"; // URL de la API v2 para realizar la adjudicación externa de una insignia
let headersList = {
"Accept": "application/json",
"Content-Type": "application/json",
"Authorization": "Bearer ISSUER_API_KEY" // Aquí se coloca la issuer_api_key (64 caracteres hex). Se obtiene en INSIGNIA UNED [Formulario de edición de Emisores].
}
let bodyContent = JSON.stringify({
"identity" : "", // Correo de la persona receptora de la insignia [max_length 255]
"name" : "", // Nombre completo real de la persona receptora de la insignia [max_length 64]
"narrative" : "", // Descripción breve del evento [max_length 256]
"evidence" : "", // Opcional: (puede ir vacío) | URI -> Dirección web de un recurso o página que presente evidencia y detalle del logro obtenido [max_length 256]
"issued_date" : "", // Fecha de adjudicación en el formato [dd/mm/YYYY] -> Día/Mes/Año [max_length 10]
"badge_uid" : "", // UID de la Insignia, el cual se obtiene en INSIGNIA UNED [Formulario de edición de Insignias] [max_length 64]
"send_mail" : "", // Se coloca un '1' si se desea enviar un correo de notificación a la persona receptora de la insignia, de lo contrario se coloca un '0'
"email_body" : "" // Opcional: (puede ir vacío) | Texto opcional que se visualizará en el cuerpo del correo enviado a la persona receptora de la insignia [max_length 512]
});
// Función asíncrona para realizar la petición POST a la API de adjudicación de insignias
async function assertion() {
let response = await fetch(url, {
method: "POST",
body: bodyContent,
headers: headersList
});
let result = await response.json();
console.log(result);
// Respuesta exitosa (HTTP 201): { awarded: true, status: "success", assertion_uid: "...", assertion_url: "..." }
// Error de validación (HTTP 400): { awarded: false, status: "error", errors: { campo: "mensaje" } }
// Error de autenticación / not found (HTTP 401/404): { awarded: false, status: "error", message: "..." }
// Límite de solicitudes (HTTP 429): { awarded: false, status: "error", message: "...", retry_after: N }
// En HTTP 429, revise también el encabezado Retry-After para reintentar.
}
// Llamado a la función para realizar la petición POST a la API de adjudicación de insignias
assertion();
// Codigo PHP para ejecutar Adjudicaciones externas desde la API: https://insignia.uned.ac.cr/assertion/api/v2/award
$url = 'https://insignia.uned.ac.cr/assertion/api/v2/award'; // URL de la API v2 para realizar la adjudicación externa de una insignia
$bodyContent =
array(
"identity" => "", // Correo de la persona receptora de la insignia [max_length 255]
"name" => "", // Nombre completo real de la persona receptora de la insignia [max_length 64]
"narrative" => "", // Descripción breve del evento [max_length 256]
"evidence" => "", // Opcional: (puede ir vacío) | URI -> Dirección web de un recurso o página que presente evidencia y detalle del logro obtenido [max_length 256]
"issued_date" => "", // Fecha de adjudicación en el formato [dd/mm/YYYY] -> Día/Mes/Año [max_length 10]
"badge_uid" => "", // UID de la Insignia, el cual se obtiene en INSIGNIA UNED [Formulario de edición de Insignias] [max_length 64]
"send_mail" => "", // Se coloca un '1' si se desea enviar un correo de notificación a la persona receptora de la insignia, de lo contrario se coloca un '0'
"email_body" => "" // Opcional: (puede ir vacío) | Texto opcional que se visualizará en el cuerpo del correo enviado a la persona receptora de la insignia [max_length 512]
);
$headersList = array(
'http' => array(
'method' => 'POST',
'header' =>
'Accept: application/json'."\r\n".
'Content-type: application/json'."\r\n".
'Authorization: Bearer ISSUER_API_KEY'."\r\n", // Aquí se coloca la issuer_api_key (64 caracteres hex). También se acepta en formato plano por compatibilidad.
'content' => json_encode($bodyContent)
)
);
$context = stream_context_create($headersList);
$result = file_get_contents($url, false, $context);
$result = json_decode($result);
var_dump($result); // Respuesta exitosa (HTTP 201): awarded=true + assertion_uid + assertion_url | Error (400/401/404): awarded=false + errors/message | Límite (429): awarded=false + retry_after
Esta versión incorpora delegación institucional completa para que las cuentas institucionales autoricen a funcionarios a gestionar recursos en su nombre sin compartir credenciales. Además, mejora la auditoría, aclara la propiedad visual de los recursos y corrige comportamientos de filtrado y eliminación en insignias.
Esta versión fortalece la seguridad general del sistema, permite cargar insignias en formato PNG, habilita un nuevo flujo de acceso temporal al portafolio para personas con correos externos, permite compartir insignias vía código QR desde el perfil público de adjudicación, mejora la administración interna y refuerza la compatibilidad con Open Badges 2.0.
/revocationlist/{badge_uid}, revokedOn y revocationReason.HTTP 410 Gone.application/ld+json./backpack_external/request-access, /backpack_external/verify y /backpack_external/profile/{email_b64}/{view_token} para solicitud, validación y consulta temporal del portafolio.Esta versión amplía fuertemente las capacidades del sistema: moderniza la adjudicación masiva, agrega validador propio, rutas de aprendizaje, catálogo público de insignias, mejoras de privacidad y una nueva API v2 para integraciones externas.
Esta versión marca la salida a estable del sistema, renueva la interfaz, moderniza la base tecnológica y consolida el cumplimiento práctico del estándar Open Badges 2.0.
{backpack} para mantener compatibilidad).
Para mayor información, asesoría, comentarios o sugerencias, por favor contactar a:
Programa de Producción Electrónica Multimedial, PEM
Correo electrónico: multimedia@uned.ac.cr