A FastAPI-based microservice that provides a clean, structured REST interface over Playtomic's private APIs. It automatically handles authentication, token persistence, and data normalization.

🚀 Key Features

Auto-Auth: Manages Bearer tokens and handles automatic 401 refresh logic.
Modular Design: Organized by domain (Users, Bookings, Clubs) for easy scaling.
Docker-Ready: Fully containerized with Docker Compose for instant deployment.
Auto-Documentation: Integrated Swagger UI and ReDoc.
Developer Friendly: Built with modern Python standards (PEP 621, Pydantic v2).

🛠 Tech Stack

Python 3.11+
FastAPI (Web framework)
Pydantic (Data validation & Settings)
Requests (HTTP Client with Session reuse)
Docker & Docker Compose

🚦 Getting Started

1. Configuration

Create a .env file in the project root based on the provided environment variables:

PROJECT_NAME="Playtomic Wrapper"
VERSION="1.0.0"
API_V1_STR="/api/v1"

PLAYTOMIC_EMAIL="your_email@example.com"
PLAYTOMIC_PASSWORD="your_password"
PLAYTOMIC_API_URL="[https://api.playtomic.io](https://api.playtomic.io)"