Saltar a contenido

Listar usuarios

GET /apientidades/v1/usuarios

Devuelve los usuarios activos autorizados de la entidad autenticada. Use estos IDs para el campo usuarioId al crear incidencias o comentar.

Ejemplo de petición

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/usuarios" \
  -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}/usuarios", headers=headers)
usuarios = response.json()

for u in usuarios:
    print(f"ID: {u['id']} - {u['nombre']} ({u['tipoDescripcion']})")

var response = await client.GetAsync($"{baseUrl}/usuarios");
var json = await response.Content.ReadAsStringAsync();
var usuarios = JsonConvert.DeserializeObject<List<UsuarioDto>>(json);

foreach (var u in usuarios)
{
    Console.WriteLine($"ID: {u.Id} - {u.Nombre} ({u.TipoDescripcion})");
}

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "$baseUrl/usuarios",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $token"
    ]
]);

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

foreach ($usuarios as $u) {
    echo "ID: {$u['id']} - {$u['nombre']} ({$u['tipoDescripcion']})\n";
}
curl_close($ch);

Respuesta exitosa (200)

[
  {
    "id": 501,
    "nombre": "ANA TORRES MEDINA",
    "activo": true,
    "tipo": 2,
    "tipoDescripcion": "Total"
  },
  {
    "id": 502,
    "nombre": "CARLOS DELGADO NAVARRO",
    "activo": true,
    "tipo": 1,
    "tipoDescripcion": "Carga"
  }
]

Campos de cada usuario

Campo Tipo Descripción
id int Identificador único del usuario. Usar en usuarioId de incidencias
nombre string Nombre completo del usuario
activo bool Si el usuario está activo (siempre true en esta respuesta)
tipo int Tipo de acceso: 0=Consultivo, 1=Carga, 2=Total
tipoDescripcion string Descripción legible del tipo de acceso

Tipos de acceso

Código Tipo Puede consultar Puede editar Puede presentar
0 Consultivo Sí No No
1 Carga Sí Sí No
2 Total Sí Sí Sí

Solo usuarios activos

Este endpoint solo devuelve usuarios activos. Los usuarios desactivados no aparecen en la lista.

Uso en incidencias

Al crear una incidencia o añadir un comentario, proporcione el id de uno de estos usuarios en el campo usuarioId. Si no se proporciona, se usa automáticamente el primer usuario de la entidad.

Errores posibles

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