Ecosistema Abierto & API REST v1

Conecta tu Clínica con el Mundo: API Abierta y OpenAPI 3.1

Tanto si quieres sincronizar las citas de tu web de WordPress/Wix como si eres una policlínica que necesita integrar su propio ERP, PodoFly ofrece una API moderna, rápida y blindada conforme al RGPD.

Ver Especificación OpenAPI 3.1 Probar en Sandbox

Para Clínicas y Podólogos

Conecta tu Web de Reservas

Integra fácilmente el formulario de reserva de citas de tu página web (WordPress, Wix, Squarespace, Webflow) directamente en tu agenda de PodoFly, evitando duplicidades de agenda y llamadas telefónicas.

Citas automáticas clasificadas por motivo (quiropodia, pisada, curas).
Creación automática de ficha de paciente en su primera visita.
Sincronización en tiempo real sin retrasos.

Para Desarrolladores y TI

API RESTful Estándar & Segura

Diseñada con los más altos estándares de ingeniería: respuestas JSON coherentes, códigos de estado HTTP semánticos, validación estricta con Zod y trazabilidad nominal de auditoría.

Autenticación por API Key (`Authorization: Bearer podo_live_...`).
Esquema estándar OpenAPI 3.1 descargable e importable en Postman / Swagger.
Cifrado de datos en reposo y tránsito con aislamiento multitenant.

Quickstart · Consulta de Citas

REST v1

// 1. Consultar disponibilidad en tiempo real para un servicio (excluye festivos y citas):

curl -X GET "https://podofly.com/api/v1/availability?service_id=1&date=2026-10-01" \
  -H "Authorization: Bearer podo_live_YOUR_API_KEY" \
  -H "Content-Type: application/json"

// 2. Respuesta con huecos libres y comprobación de festivos:

{
  "success": true,
  "timezone": "Europe/Madrid",
  "date": "2026-10-01",
  "is_holiday": false,
  "total_slots": 8,
  "slots": [
    { "time": "09:30", "professional_id": 1, "professional_name": "Dra. Laura García" },
    { "time": "10:15", "professional_id": 1, "professional_name": "Dra. Laura García" }
  ]
}

// 3. Agendar cita con motor declarativo de notificaciones (políticas por canal):

curl -X POST "https://podofly.com/api/v1/appointments" \
  -H "Authorization: Bearer podo_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_id": "c7a8b9d0-1234-5678-9abc-def012345678",
    "professional_id": 1,
    "service_id": 1,
    "date": "2026-10-01",
    "start_time": "09:30",
    "notifications": {
      "whatsapp": "mandatory",
      "email": "preferred",
      "sms": "fallback"
    },
    "notes": "Reserva automatizada vía bot de IA"
  }'

Catálogo de Endpoints REST v1

Todos los recursos soportan filtrado, paginación y cabeceras de auditoría.

Esquema OpenAPI completo →

← Desliza para explorar los endpoints →

Método	Endpoint	Descripción
GET	/api/v1/ping	Comprueba el estado de la conexión y valida la clave de API.
GET	/api/v1/professionals	Catálogo de profesionales clínicos activos y colegiados con sus especialidades y colores de agenda.
GET	/api/v1/availability	Consulta en tiempo real de huecos disponibles por fecha, profesional y servicio (excluye festivos de clínica, descansos y citas reservadas).
GET	/api/v1/patients	Lista pacientes con paginación, filtros y búsqueda de texto.
POST	/api/v1/patients	Crea nuevos pacientes con cifrado automático de datos personales.
GET	/api/v1/patients/{id}	Consulta el detalle completo de un paciente.
PATCH	/api/v1/patients/{id}	Actualiza datos de contacto o filiación del paciente.
GET	/api/v1/appointments	Consulta la agenda por rango de fechas, profesional y estado.
POST	/api/v1/appointments	Agenda nuevas citas (notificaciones multicanal con fallback Email->WhatsApp o SMS, y control de festivos).
GET	/api/v1/appointments/{id}	Detalle de una cita con notas y motivos de consulta.
PATCH	/api/v1/appointments/{id}	Reprograma o modifica el estado de una cita.
DELETE	/api/v1/appointments/{id}	Cancela o elimina una cita de la agenda con webhook saliente.
GET	/api/v1/services	Lista tarifas y servicios de quiropodia, biomecánica y cirugías con sus duraciones.
GET	/api/v1/invoices	Consulta registros de facturación oficial y estados de cobro.
GET	/api/v1/clinical/{patientId}	Lectura segura del historial clínico de un paciente (Ley 41/2002 con auditoría nominal CloudWatch).

¿Listo para integrar PodoFly en tu clínica o ecosistema?

Accede al panel de configuración de tu clínica para generar tus claves de API (`podo_live_...`) o prueba la integración completa en nuestro entorno Sandbox.

Probar en Sandbox Soporte Técnico