Consultar marcas

Desarrollando

Entorno desarrollo

https://dev-api.talentify.cr

GET

/api/tempo/personal/marca

Consulta el historial de marcas de la persona autenticada, con paginación y filtros por rango de fechas, tipo y naturaleza.

Resulta útil para verificar si una marca ya fue registrada (por día, tipo y naturaleza) y para alimentar tableros de asistencia.

Filtros disponibles

Parámetro	Descripción
`desde`	Fecha inicial del rango (`dd/mm/aaaa`).
`hasta`	Fecha final del rango (`dd/mm/aaaa`).
`tipos[]`	Uno o varios tipos de marca: `e` (entrada), `s` (salida).
`naturaleza[]`	Una o varias naturalezas: `l`, `a`, `rm`, `rt`.

La respuesta usa el formato de paginación estándar de Laravel (data, current_page, per_page, total, links, …).

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

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200Éxito

application/json

Listado paginado de marcas que cumplen los filtros, en formato de paginación de Laravel.

Bodyapplication/json

🟠422Datos incompletos

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --globoff --request GET 'https://dev-api.talentify.cr/api/tempo/personal/marca?desde=20%2F05%2F2026&hasta=20%2F05%2F2026&tipos[]=s&naturaleza[]=l' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Ejemplo de Respuesta

200 - Éxito

{
    "current_page": 1,
    "data": [
        {
            "id": 103641,
            "hora": "12:51",
            "dia": "16/02/2026",
            "horarioDescripcion": "Completo de 7 a 4",
            "minutosDiferencia": 188,
            "tipo": "salida",
            "naturaleza": "laboral",
            "inconsistente": true,
            "idPersona": 412,
            "identificacionPersona": "117870881",
            "nombrePersona": "Natali",
            "primerApellidoPersona": "Rivera",
            "segundoApellidoPersona": "Porras",
            "horaEntrada": "07:00",
            "horaSalida": "16:00",
            "latitud": null,
            "longitud": null,
            "ip": null,
            "navegador": null,
            "nombreNavegador": "Desconocido"
        }
    ],
    "first_page_url": "api/tempo/personal/marca?pagina=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "api/tempo/personal/marca?pagina=1",
    "links": [
        {
            "url": null,
            "label": "&laquo; Previous",
            "active": false
        },
        {
            "url": "api/tempo/personal/marca?pagina=1",
            "label": "1",
            "active": true
        },
        {
            "url": null,
            "label": "Next &raquo;",
            "active": false
        }
    ],
    "next_page_url": null,
    "path": "api/tempo/personal/marca",
    "per_page": 25,
    "prev_page_url": null,
    "to": 1,
    "total": 1
}

Modificado en 2026-06-10 23:59:01

Marcar facial

Cargar configuración

Consultar marcas

Filtros disponibles#

Solicitud

Respuestas

Filtros disponibles