🏥 Clínica Vallecito API v1.0.0

# Request POST /api/auth/login Content-Type: application/json { "email": "admin@clinicavallecito.com", "password": "123456" } # Response 200 { "exito": true, "mensaje": "Inicio de sesión exitoso", "datos": { "token": "eyJhbGciOiJIUzI1NiIs...", "usuario": { "idHash": "a1b2c3d4", "firstName": "Admin", "lastName": "Principal", "email": "admin@clinicavallecito.com", "role": { "id": 1, "name": "superadmin" } } } }

# Request POST /api/usuarios/admin Content-Type: application/json { "firstName": "Admin", "lastName": "Principal", "email": "admin@clinicavallecito.com", "password": "123456" } # Response 201 { "exito": true, "mensaje": "Super administrador creado", "datos": { "idHash": "a1b2c3d4", "firstName": "Admin", "lastName": "Principal", "email": "admin@clinicavallecito.com" } }

# Request GET /api/usuarios/perfil Authorization: Bearer eyJhbGciOi... # Response 200 { "exito": true, "mensaje": "Perfil obtenido", "datos": { "idHash": "a1b2c3d4", "firstName": "Admin", "lastName": "Principal", "email": "admin@clinicavallecito.com", "role": { "id": 1, "name": "superadmin" } } }

# Response 200 { "exito": true, "mensaje": "Roles obtenidos", "datos": [ { "idHash": "r1", "name": "superadmin", "description": "Acceso total", "accessLevel": 100 }, { "idHash": "r2", "name": "admin", "description": "Administrador", "accessLevel": 80 }, { "idHash": "r3", "name": "recepcionista", "description": "Recepción", "accessLevel": 30 } ] }

# Response 201 { "exito": true, "mensaje": "Roles inicializados correctamente" }

# Response 200 { "exito": true, "mensaje": "Departamentos obtenidos", "datos": [ { "idHash": "dep1", "name": "Cardiología", "themeColor": "#e53e3e" }, { "idHash": "dep2", "name": "Traumatología", "themeColor": "#3182ce" } ] }

# Request POST /api/departamentos Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "name": "Cardiología", "themeColor": "#e53e3e" } # Response 201 { "exito": true, "mensaje": "Departamento creado", "datos": { "idHash": "dep1", "name": "Cardiología", "themeColor": "#e53e3e" } }

# Response 200 { "exito": true, "mensaje": "Servicios obtenidos", "datos": [ { "idHash": "srv1", "name": "Consulta Cardiológica", "description": "Evaluación completa del corazón", "imageUrl": "/uploads/servicios/srv1.webp", "iconUrl": "/uploads/servicios/srv1_icon.webp", "department": { "idHash": "dep1", "name": "Cardiología" } } ] }

# Request (multipart/form-data) POST /api/servicios Authorization: Bearer eyJhbGciOi... name = "Consulta Cardiológica" description = "Evaluación completa del corazón" departmentId = 1 image = [archivo.jpg] # Imagen principal icon = [icono.png] # Ícono del servicio

# Response 200 { "exito": true, "mensaje": "Sub-servicios obtenidos", "datos": [ { "idHash": "ss1", "introduction": { "title": "Ecocardiograma", "description": "...", "video_url": "" }, "abstract": { "title": "Resumen", "description": "...", "image_url": "/uploads/..." }, "closing": [{ "title": "Beneficios", "description": "...", "image_url": "/uploads/..." }], "service": { "idHash": "srv1", "name": "Consulta Cardiológica" } } ] }

# Request (multipart/form-data con upload.any()) POST /api/sub-servicios Authorization: Bearer eyJhbGciOi... serviceId = 1 introduction = '{"title":"...","description":"...","video_url":""}' abstract = '{"title":"...","description":"..."}' closing = '[{"title":"...","description":"..."}]' abstract_image = [archivo.jpg] # Imagen del resumen closing_image_0 = [archivo.jpg] # Imagen del cierre[0]

# Response 200 { "exito": true, "mensaje": "Doctores obtenidos", "datos": [ { "idHash": "doc1", "firstName": "Juan", "lastName": "Pérez", "specialty": "Cardiología", "cmp": "012345", "rne": "067890", "photoUrl": "/uploads/doctores/doc1.webp" } ] }

# Request (multipart/form-data) POST /api/doctores Authorization: Bearer eyJhbGciOi... firstName = "Juan" lastName = "Pérez" specialty = "Cardiología" cmp = "012345" rne = "067890" image = [foto.jpg]

# Response 200 { "exito": true, "mensaje": "Casos de éxito obtenidos", "datos": [ { "idHash": "ce1", "treatmentName": "Cirugía de válvula mitral", "description": "Paciente recuperado en 2 semanas", "beforeImageUrl": "/uploads/casos-exito/ce1_before.webp", "afterImageUrl": "/uploads/casos-exito/ce1_after.webp", "department": { "idHash": "dep1", "name": "Cardiología" } } ] }

# Request (multipart/form-data) POST /api/casos-exito Authorization: Bearer eyJhbGciOi... treatmentName = "Cirugía de válvula mitral" description = "Paciente recuperado en 2 semanas" departmentId = 1 beforeImage = [antes.jpg] afterImage = [despues.jpg]

# Response 200 { "exito": true, "mensaje": "Infraestructuras obtenidas", "datos": [ { "idHash": "inf1", "name": "Sala de Operaciones", "title": "Quirófano Principal", "subTitle": "Equipado con tecnología de última generación", "description": "...", "imageUrl": "/uploads/infraestructuras/inf1.webp", "department": { "idHash": "dep1", "name": "Cardiología" } } ] }

# Request (multipart/form-data) POST /api/infraestructuras Authorization: Bearer eyJhbGciOi... name = "Sala de Operaciones" title = "Quirófano Principal" subTitle = "Equipado con tecnología de última generación" description = "Sala de operaciones con equipos modernos" departmentId = 1 image = [foto.jpg]

# Response 200 { "exito": true, "mensaje": "Sponsors obtenidos", "datos": [ { "idHash": "sp1", "name": "Laboratorio Clínico del Sur", "logoUrl": "/uploads/sponsors/sp1.webp" } ] }

# Request (multipart/form-data) POST /api/sponsors Authorization: Bearer eyJhbGciOi... name = "Laboratorio Clínico del Sur" image = [logo.png]

# Request GET /api/citas Authorization: Bearer eyJhbGciOi... # Response 200 { "exito": true, "mensaje": "Citas obtenidas", "datos": [ { "idHash": "ct1", "fullName": "María López Gutiérrez", "email": "maria@email.com", "phone": "951234567", "message": "Consulta por dolor en el pecho", "status": "pending", "department": { "idHash": "dep1", "name": "Cardiología" } } ] }

# Request (público — no requiere token) POST /api/citas Content-Type: application/json { "fullName": "María López Gutiérrez", "email": "maria@email.com", "phone": "951234567", "message": "Consulta por dolor en el pecho", "departmentId": 1 } # Response 201 { "exito": true, "mensaje": "Cita creada", "datos": { "idHash": "ct1", "status": "pending" } }

# Response 200 { "exito": true, "mensaje": "Configuraciones obtenidas", "datos": [ { "idHash": "pg1", "settingKey": "hero_banner", "settingValue": { "fields": [ { "key": "titulo", "label": "Título principal", "value": "Clínica Vallecito", "type": "text" }, { "key": "subtitulo", "label": "Subtítulo", "value": "Tu salud es nuestra prioridad", "type": "text" } ], "image": "/uploads/configuraciones/hero_banner.webp" }, "department": null } ] }

# Request (multipart/form-data) POST /api/configuraciones Authorization: Bearer eyJhbGciOi... settingKey = "hero_banner" settingValue = '{ "fields": [ { "key": "titulo", "label": "Título", "value": "Clínica Vallecito", "type": "text" }, { "key": "subtitulo", "label": "Subtítulo", "value": "Tu salud...", "type": "text" } ] }' departmentId = "" image = [banner.jpg] # Imagen opcional

# Actualizar campos y/o imagen (se mantienen ambos) PUT /api/configuraciones/hero_banner Authorization: Bearer eyJhbGciOi... settingValue = '{"fields":[...]}' image = [nueva_imagen.jpg] # Opcional _removeImage = "true" # Para quitar solo la imagen

# Request GET /api/entity-images?entityType=infrastructure&entityIdHash=inf1 # Response 200 { "exito": true, "mensaje": "Imágenes obtenidas", "datos": [ { "idHash": "img1", "imageUrl": "/uploads/gallery/img1.webp", "caption": "Vista frontal", "displayOrder": 0, "isVisible": true } ] }

# Request (multipart/form-data) POST /api/entity-images Authorization: Bearer eyJhbGciOi... entityType = "infrastructure" entityIdHash = "inf1" images = [foto1.jpg, foto2.jpg, ...] # Hasta 20 archivos

# Request PUT /api/entity-images/reorder Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "images": [ { "idHash": "img2", "displayOrder": 0 }, { "idHash": "img1", "displayOrder": 1 } ] }

# Request PUT /api/entity-images/img1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "isVisible": false, "caption": "Vista lateral" }