Documentación del API

API pública para consultar e integrar la información de pacientes, hospitales y reportes.

Base URL

Todas las rutas cuelgan de:

https://asistencia.codx.com.ve/api

Las respuestas son JSON y las fechas usan formato ISO-8601 (UTC).

Autenticación

Los endpoints de lectura (consultar pacientes, hospitales, mapa, heridos) y el de cambio de estado son públicos, no requieren token.

Los endpoints de escritura (crear/editar/eliminar pacientes, administración) usan token Bearer (Sanctum). Obtén uno con POST /api/login (correo y contraseña) o genéralo desde el panel /admin. Luego envíalo en cada petición:

Authorization: Bearer <tu-token>

Límite de tasa (rate limit)

60 peticiones por minuto, contabilizadas por usuario autenticado o por IP. Al excederlo, la API responde 429 Too Many Requests.

Endpoints

Método	Ruta	Auth	Descripción
GET	/pacientes	Público	Lista paginada (filtros: search, estado, hospital, per_page≤100)
GET	/pacientes/{id}	Público	Detalle de un paciente
GET	/pacientes/formato	Público	Esquema esperado para crear pacientes
POST	/pacientes	Bearer	Crear paciente
PUT	/pacientes/{id}	Bearer	Editar paciente
DELETE	/pacientes/{id}	Bearer	Eliminar paciente
PATCH	/pacientes/{id}/estado	Público	Actualizar estado (público)
POST	/pacientes/importar	Público	Importar Excel/CSV (PDF/imagen solo admin)
GET	/hospitales	Público	Hospitales distintos
GET	/hospitales/mapa	Público	Hospitales geolocalizados + conteos
GET	/hospitales/{hospital}/pacientes	Público	Pacientes de un hospital
GET	/heridos	Público	Reportes de heridos
POST	/heridos	Público	Reportar herido con ubicación (GPS o URL Maps)
POST	/login	Público	Obtener token Bearer (correo + contraseña)
GET	/admin/estadisticas	Bearer	Estadísticas agregadas
GET	/admin/auditoria	Bearer	Bitácora de cambios

Modelo de respuesta (paciente)

Cada paciente expone estos campos:

id — identificador
nombre_completo
documento_identidad
telefono
fecha_ingreso — ISO-8601
hospital
ubicacion_interna
estado — Ingresado · Alta · Fallecido · Desaparecido
medicamentos_necesarios
historia_medica
campos_adicionales — objeto JSON
informacion_adicional — texto
created_at / updated_at

Ejemplo de respuesta — `GET /api/pacientes`

{
  "data": [
    {
      "id": 1,
      "nombre_completo": "Juan Pérez García",
      "documento_identidad": "12345678",
      "telefono": null,
      "fecha_ingreso": "2026-06-25T10:30:00Z",
      "hospital": "Hospital Universitario de Caracas",
      "ubicacion_interna": "Piso 2 - Cama 4",
      "estado": "Ingresado",
      "medicamentos_necesarios": null,
      "historia_medica": null,
      "campos_adicionales": {},
      "informacion_adicional": "",
      "created_at": "2026-06-25T10:30:00Z",
      "updated_at": "2026-06-28T20:48:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 15,
    "total": 73
  }
}