Skip to main content

Overview

This document lists all API endpoints discovered in the Biométrico application source code. All endpoints are prefixed with the base URL configured in __API_BIOMETRICO__.

Authentication Endpoints

Login

Authenticates a user and returns a JWT token.
POST /biometrico/login
email
string
required
User’s email address
password
string
required
User’s password
token
string
JWT authentication token
token_type
string
Token type (typically “Bearer”)
Role
string
User role (sotics, atics, or sa)
email
string
User’s email address
name
string
User’s full name
Source: src/assets/js/function/login_function.js

Docentes (Teachers) Endpoints

Get Teachers List

Retrieves a paginated list of teachers.
GET /biometrico/getdocentes
page
number
Page number for pagination
perPage
number
Number of records per page
Search query for filtering teachers
Source: src/components/fotos/docentes_foto.vue:594

Get Individual Teacher

Retrieves detailed information for a specific teacher by CI (Cédula).
GET /biometrico/getindivDoc/{ci}
ci
string
required
Teacher’s CI (identification number)
Source: src/components/Registro/RegistroIndivDoc.vue:264

Get Teacher Person Data

Retrieves person data from the biometric system for a teacher.
GET /biometrico/getperson/{ci}
ci
string
required
Teacher’s CI (identification number)
v
number
Cache-busting parameter (timestamp)
Source: src/components/fotos/docentes_foto.vue:468

Compare HikCentral Data

Compares local data with HikCentral biometric system data for a teacher.
GET /biometrico/compare-hikdoc/{ci}
ci
string
required
Teacher’s CI (identification number)
v
number
Cache-busting parameter (timestamp)
Source: src/components/fotos/docentes_foto.vue:527

Sync Teacher to HikCentral

Synchronizes a teacher’s data to the HikCentral biometric system.
POST /biometrico/sync-hikcentral/{ci}
ci
string
required
Teacher’s CI (identification number)
Source: src/components/fotos/docentes_foto.vue:504

Update Teacher in HikCentral

Updates an existing teacher’s data in the HikCentral system.
POST /biometrico/sync-hikdupdatedoce/{ci}
ci
string
required
Teacher’s CI (identification number)
Source: src/components/Registro/RegistroIndivDoc.vue:374

Get Pending Sync Teachers

Retrieves list of teachers pending synchronization with HikCentral.
GET /biometrico/get-pending-sync
page
number
Page number for pagination
perPage
number
Number of records per page
Source: src/components/fotos/docentes_foto.vue:424

Clear Cache

Clears cached data for a specific teacher.
GET /biometrico/clear-cache/{ci}
ci
string
required
Teacher’s CI (identification number)
Source: src/components/fotos/docentes_foto.vue:559

Download Teachers Photos (Bulk)

Downloads a ZIP file containing photos of multiple teachers.
GET /biometrico/descargarfotosmasivadoc
carreras
array
List of career/department IDs to filter teachers
periodo
string
Academic period
Response: ZIP file (binary data) Source: src/components/fotos/docentes_foto.vue:660

Estudiantes (Students) Endpoints

Get Students List

Retrieves a paginated list of regular students.
GET /biometrico/estudiantesfoto
page
number
Page number for pagination
perPage
number
Number of records per page
search
string
Search query for filtering students
Source: src/components/fotos/estudiantes_foto.vue:550

Get Individual Student

Retrieves detailed information for a specific student.
GET /biometrico/getindivEst/{ci}
ci
string
required
Student’s CI (identification number)
periodo
string
Academic period filter
Source: src/components/Registro/RegistroIndivEst.vue:291

Get Student Person Data

Retrieves person data from the biometric system for a student.
GET /biometrico/getperson-est/{ci}
ci
string
required
Student’s CI (identification number)
v
number
Cache-busting parameter (timestamp)
Source: src/components/fotos/estudiantes_foto.vue:437

Compare HikCentral Data (Student)

Compares local data with HikCentral biometric system data for a student.
GET /biometrico/compare-hikdoc-est/{ci}
ci
string
required
Student’s CI (identification number)
v
number
Cache-busting parameter (timestamp)
Source: src/components/fotos/estudiantes_foto.vue:497

Sync Student to HikCentral

Synchronizes a student’s data to the HikCentral biometric system.
POST /biometrico/sync-hikdoc/{ci}
ci
string
required
Student’s CI (identification number)
Source: src/components/fotos/estudiantes_foto.vue:473

Sync Student with ID

Synchronizes a student’s data including their ID.
POST /biometrico/sync-hikdoc-est-id/{ci}
ci
string
required
Student’s CI (identification number)
periodo
string
Academic period
Source: src/components/Registro/RegistroIndivEst.vue:353

Update Student in HikCentral

Updates an existing student’s data in the HikCentral system.
POST /biometrico/sync-hikdoc-update/{ci}
ci
string
required
Student’s CI (identification number)
Source: src/components/Registro/RegistroIndivEst.vue:404

Get Pending Sync Students

Retrieves list of students pending synchronization with HikCentral.
GET /biometrico/get-pending-sync-est
page
number
Page number for pagination
perPage
number
Number of records per page
Source: src/components/fotos/estudiantes_foto.vue:389

Get Academic Periods

Retrieves available academic periods for student registration.
GET /biometrico/get-periodos-rec
Source: src/components/Registro/RegistroIndivEst.vue:265

Pre-Estudiantes (Pre-Students) Endpoints

Get Pre-Students List

Retrieves a paginated list of pre-students (applicants/pre-enrolled).
GET /biometrico/estudiantesfoto-pre-est
page
number
Page number for pagination
perPage
number
Number of records per page
search
string
Search query for filtering pre-students
Source: src/components/fotos/estudiantes_pre_foto.vue:550

Get Individual Pre-Student

Retrieves detailed information for a specific pre-student.
GET /biometrico/getindivEst-pre-est/{ci}
ci
string
required
Pre-student’s CI (identification number)
Source: src/components/Registro/RegistroIndivPreEst.vue:263

Get Pre-Student Person Data

Retrieves person data from the biometric system for a pre-student.
GET /biometrico/getperson-pre-est/{ci}
ci
string
required
Pre-student’s CI (identification number)
Source: src/components/fotos/estudiantes_pre_foto.vue:437

Compare HikCentral Data (Pre-Student)

Compares local data with HikCentral biometric system data for a pre-student.
GET /biometrico/compare-hikdoc-pre-est/{ci}
ci
string
required
Pre-student’s CI (identification number)
v
number
Cache-busting parameter (timestamp)
Source: src/components/fotos/estudiantes_pre_foto.vue:497

Sync Pre-Student to HikCentral

Synchronizes a pre-student’s data to the HikCentral biometric system.
POST /biometrico/sync-hikcentral-pre-est/{ci}
ci
string
required
Pre-student’s CI (identification number)
Source: src/components/fotos/estudiantes_pre_foto.vue:473

Sync Pre-Student with ID

Synchronizes a pre-student’s data including their ID.
POST /biometrico/sync-hikdoc-est-id-pre-est/{ci}
ci
string
required
Pre-student’s CI (identification number)
Source: src/components/Registro/RegistroIndivPreEst.vue:323

Update Pre-Student in HikCentral

Updates an existing pre-student’s data in the HikCentral system.
POST /biometrico/sync-hikdoc-update-pre-est/{ci}
ci
string
required
Pre-student’s CI (identification number)
Source: src/components/Registro/RegistroIndivPreEst.vue:372

Get Pending Sync Pre-Students

Retrieves list of pre-students pending synchronization with HikCentral.
GET /biometrico/get-pending-sync-pre-est
page
number
Page number for pagination
perPage
number
Number of records per page
Source: src/components/fotos/estudiantes_pre_foto.vue:389

Shared Endpoints

Get Careers List

Retrieves a list of available careers/programs.
GET /biometrico/carrerasList
Source: src/components/fotos/estudiantes_foto.vue:522

Get Photo

Retrieves a photo for a person by their CI.
GET /biometrico/fotografia/{ci}
ci
string
required
Person’s CI (identification number)
responseType
string
default:"blob"
Response type for the image data
Response: Image file (binary data) Source: src/components/fotos/estudiantes_foto.vue:617

Download Photos (Bulk)

Downloads a ZIP file containing multiple photos.
GET /biometrico/descargarfotosmasiva
carreras
array
List of career/program IDs to filter
periodo
string
Academic period
responseType
string
default:"blob"
Response type (should be “blob” for binary data)
Response: ZIP file (binary data) Source: src/components/fotos/estudiantes_foto.vue:655

Common Request Patterns

Pagination

Many endpoints support pagination using query parameters:
const response = await API.get('/biometrico/getdocentes', {
  params: {
    page: 1,
    perPage: 50,
    search: 'John'
  }
});

Cache Busting

Several endpoints use a version parameter to bypass caching:
const refreshKey = Date.now();
const response = await API.get(`/biometrico/getperson/${ci}?v=${refreshKey}`);

File Downloads

For endpoints that return files, use responseType: 'blob':
const response = await API.get('/biometrico/fotografia/1234567', {
  responseType: 'blob'
});

Error Responses

All endpoints may return the following error responses:
401
error
Unauthorized - Invalid or expired token. User will be automatically redirected to login.
404
error
Not Found - The requested resource does not exist.
500
error
Internal Server Error - An error occurred on the server.

Notes

  • All endpoints require authentication except for the login endpoint
  • The Authorization header is automatically added by the Axios interceptor
  • CI (Cédula de Identidad) is used as the primary identifier for people
  • HikCentral is the external biometric system that data is synchronized with
  • Pre-students are applicants or pre-enrolled students not yet fully registered

Build docs developers (and LLMs) love