Grupos

Entorno desarrollo

https://dev-api.talentify.cr

GET

/api/seguridad/grupos

Lista de forma paginada los grupos de seguridad (roles) de la unidad de negocio, ordenados por nombre.

Cada grupo incluye sus usuarios y permisos asignados, además de permisividad, la proporción de permisos otorgados respecto al total disponible.

Solicitud

Autorización

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de consulta

Parámetros de Header

Respuestas

🟢200Éxito

application/json

Página de grupos de seguridad, en formato de paginación de Laravel.

Bodyapplication/json

🟠401No autentificado

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://dev-api.talentify.cr/api/seguridad/grupos?cantidadPorPagina=2&pagina=12' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Ejemplo de Respuesta

200 - Success

{
    "current_page": 1,
    "data": [
        {
            "id": 504,
            "nombre": "Administrativo",
            "descripcion": "Acceso a la configuración general de la unidad",
            "fechaCreacion": "10/06/2026 09:15",
            "borrable": true,
            "activo": true,
            "creadoPor": {
                "id": 7472,
                "persona": 8061,
                "nombre": "Alexander",
                "primerApellido": "Arias",
                "segundoApellido": "Pérez",
                "correoElectronico": "alexander@prueba.com",
                "nacionalidad": "CRC",
                "tipoIdentificacion": "01",
                "identificacion": "167845672",
                "fechaCreacion": "10/06/2026 09:15:00",
                "tipo": "proveedor",
                "administrador": false,
                "activo": true,
                "foto": {
                    "url": "https://dev-talentify.twic.pics/web/img/um.png?twic=v1"
                },
                "roles": [],
                "grupos": [
                    "Administrativo"
                ]
            },
            "actualizadoPor": {
                "id": 7472,
                "persona": 8061,
                "nombre": "Alexander",
                "primerApellido": "Arias",
                "segundoApellido": "Pérez",
                "correoElectronico": "alexander@prueba.com",
                "nacionalidad": "CRC",
                "tipoIdentificacion": "01",
                "identificacion": "167845672",
                "fechaCreacion": "10/06/2026 09:15:00",
                "tipo": "proveedor",
                "administrador": false,
                "activo": true,
                "foto": {
                    "url": "https://dev-talentify.twic.pics/web/img/um.png?twic=v1"
                },
                "roles": [],
                "grupos": [
                    "Administrativo"
                ]
            },
            "usuarios": [
                {
                    "id": 7472,
                    "persona": 8061,
                    "nombre": "Alexander",
                    "primerApellido": "Arias",
                    "segundoApellido": "Pérez",
                    "correoElectronico": "alexander@prueba.com",
                    "nacionalidad": "CRC",
                    "tipoIdentificacion": "01",
                    "identificacion": "167845672",
                    "fechaCreacion": "10/06/2026 09:15:00",
                    "tipo": "proveedor",
                    "administrador": false,
                    "activo": true,
                    "foto": {
                        "url": "https://dev-talentify.twic.pics/web/img/um.png?twic=v1"
                    },
                    "roles": [],
                    "grupos": [
                        "Administrativo"
                    ]
                }
            ],
            "permisos": [
                {
                    "identificador": "base.unidad.editar",
                    "categoria": "BASE",
                    "orden": 2
                },
                {
                    "identificador": "seguridad.grupo.mostrar",
                    "categoria": "SEGURIDAD",
                    "orden": 3
                }
            ],
            "permisividad": 0.42
        }
    ],
    "first_page_url": "api/seguridad/grupos?pagina=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "api/seguridad/grupos?pagina=1",
    "links": [
        {
            "url": null,
            "label": "&laquo; Previous",
            "active": false
        },
        {
            "url": "api/seguridad/grupos?pagina=1",
            "label": "1",
            "active": true
        },
        {
            "url": null,
            "label": "Next &raquo;",
            "active": false
        }
    ],
    "next_page_url": null,
    "path": "api/seguridad/grupos",
    "per_page": 25,
    "prev_page_url": null,
    "to": 1,
    "total": 1
}

Modificado en 2026-06-11 15:07:45

Cuenta

Registrar grupo