Saltar a contenido

Listar evaluaciones

GET /apientidades/v1/evaluaciones

Devuelve las evaluaciones en las que la entidad autenticada tiene declaración, con información resumida de cada una.

Parámetros de consulta

Parámetro Tipo Obligatorio Default Descripción
page int No 0 Página a obtener (base 0)
size int No 20 Registros por página (máximo 100)

Ejemplo de petición

# Obtener la primera página con 10 resultados
curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/evaluaciones?page=0&size=10" \
  -H "Authorization: Bearer $TOKEN" | jq .

import requests

BASE_URL = "https://apientidades-pro.transparenciacanarias.org/apientidades/v1"
headers = {"Authorization": f"Bearer {token}"}

response = requests.get(
    f"{BASE_URL}/evaluaciones",
    headers=headers,
    params={"page": 0, "size": 10}
)
data = response.json()

for ev in data["data"]:
    print(f"{ev['evaluacionId']}: {ev['evaluacion']} - {ev['estado']}")

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

var response = await client.GetAsync(
    $"{baseUrl}/evaluaciones?page=0&size=10");
var json = await response.Content.ReadAsStringAsync();
var result = JsonConvert.DeserializeObject<PaginatedResponse<EvaluacionResumen>>(json);

foreach (var ev in result.Data)
{
    Console.WriteLine($"{ev.EvaluacionId}: {ev.Evaluacion} - {ev.Estado}");
}

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "$baseUrl/evaluaciones?page=0&size=10",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $token"
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

foreach ($data['data'] as $ev) {
    echo "{$ev['evaluacionId']}: {$ev['evaluacion']} - {$ev['estado']}\n";
}
curl_close($ch);

Respuesta exitosa (200)

{
  "data": [
    {
      "evaluacionId": 10,
      "evaluacion": "Evaluacion ITCanarias 2024",
      "declaracionId": 5001,
      "estado": "NoPresentada",
      "estadoCodigo": 1,
      "ultimaPuntuacion": 72.5,
      "denominacionMapa": "ITCanarias",
      "estadoEvaluacion": "Abierta",
      "periodoInicio": "2024-01-01T00:00:00Z",
      "periodoFin": "2024-12-31T23:59:59Z"
    }
  ],
  "total": 1,
  "page": 0,
  "size": 20,
  "totalPages": 1
}

Campos del objeto EvaluacionResumen

Campo Tipo Descripción
evaluacionId int Identificador único de la evaluación
evaluacion string Título descriptivo de la evaluación
declaracionId int ID de la declaración de la entidad en esta evaluación
estado string Estado actual de la declaración (SinAbrir, NoPresentada, PendienteRevision, etc.)
estadoCodigo int Código numérico del estado (0-6). Ver enums
ultimaPuntuacion decimal Última puntuación obtenida (0-100)
denominacionMapa string Nombre corto del indicador (ej: "ITCanarias")
estadoEvaluacion string Estado de la evaluación global (Pendiente, Abierta, Cerrada, etc.)
periodoInicio datetime Inicio del período evaluado (ISO 8601)
periodoFin datetime Fin del período evaluado (ISO 8601)

Campos del envelope de paginación

Campo Tipo Descripción
data array Registros de la página actual
total int Total de registros sin paginar
page int Página actual (base 0)
size int Registros por página
totalPages int Total de páginas disponibles

Errores posibles

Código Descripción
401 Token ausente, expirado o inválido

Paginación

Si la entidad participa en muchas evaluaciones, use los parámetros page y size para paginar los resultados. El máximo de registros por página es 100.

Solo evaluaciones con declaración

Este endpoint solo devuelve evaluaciones en las que la entidad tiene una declaración asociada. Si no aparece una evaluación, puede que la entidad aún no haya sido incluida por el Comisionado.