🔑 Tus API Keys
Cargando...
📡 Base URL
https://dental-add.web.app/api/v1
Authorization: Bearer {tu_api_key}
📋 Endpoints disponibles
GET
/citas/hoy
Citas del día actual
Retorna todas las citas agendadas para hoy en tu clínica.
| Header | Descripción | Requerido |
|---|---|---|
| Authorization | Bearer {api_key} | Sí |
Respuesta exitosa (200):
{
"fecha": "2026-06-07",
"total": 8,
"citas": [
{
"id": "abc123",
"paciente": "García López María",
"hora": "09:00",
"tratamiento": "Limpieza dental",
"doctor": "Dr. Hernández",
"estado": "Agendado",
"tel": "5512345678"
}
]
}
curl -X GET https://dental-add.web.app/api/v1/citas/hoy \
-H "Authorization: Bearer {tu_api_key}"
GET
/pacientes
Lista de pacientes (paginada)
| Parámetro | Descripción | Default |
|---|---|---|
| limit | Resultados por página | 20 |
| page | Número de página | 1 |
| q | Buscar por nombre | — |
curl -X GET "https://dental-add.web.app/api/v1/pacientes?limit=20&page=1" \
-H "Authorization: Bearer {tu_api_key}"
GET
/pacientes/{id}
Expediente completo de un paciente
Retorna el expediente completo incluyendo tratamientos, abonos y citas pasadas.
curl -X GET https://dental-add.web.app/api/v1/pacientes/px123 \
-H "Authorization: Bearer {tu_api_key}"
POST
/citas
Crear nueva cita
{
"paciente": "García López María",
"tel": "5512345678",
"fecha": "2026-06-15",
"hora": "10:30",
"tratamiento": "Consulta general",
"doctor": "Dr. Hernández"
}
curl -X POST https://dental-add.web.app/api/v1/citas \
-H "Authorization: Bearer {tu_api_key}" \
-H "Content-Type: application/json" \
-d '{"paciente":"García López María","fecha":"2026-06-15","hora":"10:30"}'
GET
/metricas/resumen
KPIs del mes actual
{
"mes": "2026-06",
"ingresos_mes": 48500,
"pacientes_nuevos": 12,
"citas_completadas": 87,
"tasa_asistencia": 0.92
}
DELETE
/citas/{id}
Cancelar una cita
curl -X DELETE https://dental-add.web.app/api/v1/citas/abc123 \
-H "Authorization: Bearer {tu_api_key}"
⚙️ Implementación (Firebase Functions)
La API REST se implementa como Firebase Functions. El código base está listo — solo necesitas desplegarlo:
npm install -g firebase-tools
firebase init functions # selecciona dental-add
firebase deploy --only functions
El middleware de autenticación valida el API key contra Firestore en clinicas/{id}/apiKeys/{key} antes de procesar cada request.