Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Bryacg/Adutem/llms.txt

Use this file to discover all available pages before exploring further.

El endpoint /api/person gestiona el registro y consulta de personas (socios) en ADUTEM. Soporta listar todos los registros existentes con GET y crear nuevos registros con POST.

GET /api/person

Retorna la lista completa de personas registradas.
curl http://localhost:3000/api/person
Respuesta (200):
{
  "personas": [
    {
      "id": 1,
      "nombre": "Juan",
      "apellido": "Pérez",
      "cedula": "1300000001",
      "fecha_nacimiento": "1980-05-15T00:00:00.000Z",
      "direccion": "Av. Universitaria s/n",
      "telefono": "0999000001",
      "nombres_padres": "Pedro Pérez",
      "nombres_madre": "María López",
      "alergias": null,
      "tipo_sangre": "O+",
      "correo": "jperez@utm.edu.ec",
      "creacion_persona": "2026-01-10T14:30:00.000Z"
    }
  ]
}

POST /api/person

Crea una nueva persona/socio en el sistema. Parámetros del cuerpo (JSON):
nombre
string
required
Primer nombre (máx. 100 caracteres)
apellido
string
required
Apellido (máx. 100 caracteres)
cedula
string
required
Número de cédula de identidad, único en el sistema (máx. 20 caracteres)
fecha_nacimiento
string
required
Fecha de nacimiento en formato ISO 8601 (ej. "1980-05-15")
direccion
string
required
Dirección de residencia (máx. 255 caracteres)
telefono
string
required
Número de teléfono (máx. 20 caracteres)
nombres_padres
string
required
Nombres completos del padre (máx. 255 caracteres)
nombres_madre
string
required
Nombres completos de la madre (máx. 255 caracteres)
tipo_sangre
string
required
Tipo de sangre. Valores: A+, A-, B+, B-, AB+, AB-, O+, O-
correo
string
required
Correo electrónico único (máx. 100 caracteres)
alergias
string
Descripción de alergias conocidas (opcional)
Ejemplo:
curl -X POST http://localhost:3000/api/person \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Ana",
    "apellido": "Torres",
    "cedula": "1300000002",
    "fecha_nacimiento": "1985-03-20",
    "direccion": "Calle Bolívar 123",
    "telefono": "0987654321",
    "nombres_padres": "Carlos Torres",
    "nombres_madre": "Rosa Vera",
    "tipo_sangre": "A+",
    "correo": "atorres@utm.edu.ec"
  }'
Respuestas:
CódigoDescripción
201Persona creada exitosamente
400Faltan campos obligatorios
409La cédula o correo ya está registrado
500Error interno del servidor

GET /api/person/[id]

Retorna los datos de una persona específica. El ID se pasa como query parameter ?id=.
curl "http://localhost:3000/api/person/1?id=1"
Respuesta (200):
{
  "personas": {
    "id": 1,
    "nombre": "Juan",
    "apellido": "Pérez",
    "cedula": "1300000001",
    "correo": "jperez@utm.edu.ec"
  }
}
Respuestas de error:
CódigoDescripción
404Persona no encontrada
500Error interno del servidor

Build docs developers (and LLMs) love