GET /templates/{id}

Obtiene los detalles completos de un template, incluyendo los campos requeridos para emision.

Request

GET /api/v1/templates/{template_id}

Headers

Header	Requerido	Descripcion
X-API-Key	Si	Tu API key

Path Parameters

Parametro	Tipo	Descripcion
template_id	UUID	ID del template

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Certificado de Completitud - Curso Python",
  "description": "Certificado otorgado a estudiantes que completaron el curso",
  "achievement_type": "Certificate",
  "criteria_narrative": "El estudiante debe completar todos los modulos y aprobar el examen final",
  "image_url": "https://app.unicreda.com/api/v1/images/abc123",
  "issuer_name": "Universidad Nacional",
  "has_result": true,
  "result_type": "LetterGrade",
  "result_allowed_values": ["A", "B", "C", "D", "F"],
  "credits_available": 6.0,
  "requires_evidence": false,
  "expiration_months": 24,
  "required_fields": [
    {"name": "email", "type": "string", "description": "Recipient email address"},
    {"name": "recipient_name", "type": "string", "description": "Recipient full name"},
    {"name": "result_value", "type": "string", "description": "Grade/result (LetterGrade) - Allowed: A, B, C, D, F"},
    {"name": "credits_earned", "type": "number", "description": "Credits earned (max 6.0)"}
  ],
  "optional_fields": []
}

Campos adicionales

Campo	Descripcion
criteria_narrative	Texto con los criterios de otorgamiento
issuer_name	Nombre de la organizacion emisora
has_result	Si requiere calificacion/resultado
result_type	Tipo de resultado (LetterGrade, Percent, etc.)
result_allowed_values	Valores permitidos para result_value
credits_available	Creditos maximos disponibles
requires_evidence	Si requiere evidencia adjunta
expiration_months	Meses hasta la expiracion (null = no expira)

Errores

Status	Detalle	Causa
400	Invalid template_id format	El ID no es un UUID valido
404	Template not found	Template no existe o no pertenece a tu organizacion

Ejemplo

curl -X GET "https://app.unicreda.com/api/v1/templates/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: uc_live_tu_key_aqui"