Medical Appointment Management API

Quick Start

Get up and running with the Medical Appointment API in minutes

Clone and run the project

Clone the repository and run the API locally:

git clone https://github.com/redox11223/ServiciosWebPreliminar.git
cd ServiciosWebPreliminar
dotnet run

The API will start on https://localhost:5001 with the Scalar API documentation interface available at /scalar/v1.

Explore the API documentation

Open your browser to view the interactive API documentation powered by Scalar:

https://localhost:5001/scalar/v1

This provides a beautiful interface to explore all available endpoints, test requests, and view response schemas.

Make your first API call

Try creating a new patient with a POST request:

curl -X POST https://localhost:5001/api/Paciente \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Juan",
    "apellido": "Pérez",
    "dni": "12345678",
    "email": "[email protected]",
    "telefono": "+34600123456",
    "fechaNacimiento": "1990-05-15"
  }'

Explore the API

Comprehensive documentation for all API endpoints and features

Patients

Manage patient records with full CRUD operations

Doctors

Handle doctor information and specialty assignments

Appointments

Schedule and track medical appointments with status management

Specialties

Organize medical specialties and assign them to doctors

Key Features

Everything you need to build a medical appointment system

RESTful Design

Clean, predictable API following REST best practices

OpenAPI Support

Full OpenAPI 3.0 specification with Scalar UI

Type Safety

Built with .NET 10 and C# for robust type checking

Service Layer

Clean architecture with dependency injection

Status Management

Track appointments through Pending, Confirmed, Cancelled, and Completed states

Data Validation

Strong validation with DTOs and required fields

Learn More

Dive deeper into concepts and guides

Architecture

Understand the service-oriented architecture and design patterns

Data Models

Explore the entity and DTO structures used throughout the API

Development Guide

Learn how to extend and customize the API for your needs

Testing

Best practices for testing your API integration

Ready to get started?

Follow our quickstart guide to have your first API call running in minutes

View Quickstart Guide

Get Started

Core Concepts

Guides