Skip to main content

Overview

The Medical Center API is a RESTful API built to manage medical appointments, doctor schedules, patient information, and administrative tasks for healthcare facilities. It provides a complete backend solution for medical centers to streamline their operations.

Key Features

Appointment Management

Create, confirm, and track patient appointments with real-time status updates

Doctor Management

Manage doctor profiles, specialties, and availability

Role-Based Access

Secure authentication with admin and assistant roles

Public Endpoints

Allow patients to book appointments without authentication

Use Cases

For Medical Centers

  • Appointment Scheduling: Patients can request appointments through a public endpoint, and staff can confirm and assign doctors
  • Staff Management: Administrators can manage doctors, specialties, and internal staff with role-based permissions
  • Patient Records: Track appointment history and patient interactions

For Developers

  • Easy Integration: RESTful API with JSON responses
  • Secure Authentication: Supabase JWT-based authentication
  • Scalable Architecture: Built on modern technologies for reliability

Architecture

The Medical Center API is built with a modern, scalable stack:
1

Node.js & Express.js

Fast and lightweight web framework for handling HTTP requests
2

Prisma ORM

Type-safe database access with automated migrations and schema management
3

PostgreSQL

Robust relational database for storing medical records and appointments
4

Supabase Authentication

Secure JWT-based authentication for admin and assistant users

Core Entities

The API manages the following core entities:
  • Personas: Internal staff members (admins, assistants, doctors)
  • Usuarios: Authenticated users with role-based access (admin, asistente)
  • Clientes Públicos: Public patients who request appointments
  • Médicos: Doctors with specialties and credentials
  • Especialidades: Medical specialties (Cardiology, Pediatrics, etc.)
  • Citas: Appointment requests and confirmations
  • Historial: Medical history and notes for completed appointments

API Endpoints

The API is organized into the following endpoint groups:
  • /api/personas - Manage internal staff
  • /api/usuarios - User management
  • /api/medicos - Doctor management (public and admin)
  • /api/especialidades - Medical specialties
  • /api/citas - Appointment management
  • /api/historial - Medical history
  • /api/contacto - Contact messages from patients
  • /api/admin-auth - Administrative authentication
  • /api/dashboard - Dashboard statistics

Next Steps

Quickstart

Get up and running with the API in minutes

Authentication

Learn how to authenticate and secure your requests

Build docs developers (and LLMs) love