Interactive Documentation

Explore the Youthes E-Commerce API

This documentation helps to understand how the Youthes backend is structured, what business flows it supports, and how each endpoint works across storefront and admin experiences.

JWT Auth Role-Based Access Cart + Orders Admin Dashboard APIs

Browse Endpoints Read Narrative Guide

Base URL

/api/v1

A versioned REST API built for both customer-facing shopping flows and admin operations.

https://youthes-api.duckdns.org/api/v1

Coverage

8 Modules

Covering authentication, catalog browsing, cart operations, checkout, orders, users, content pages, and testimonials.

Auth Header

Visitors can use this format to test protected routes inside the interactive reference.

Authorization: Bearer <jwt-token>

What this API demonstrates

This backend goes beyond basic CRUD by handling role-based access, cart merge behavior, stock-aware ordering, controlled order status transitions, customer management, and editable platform content.

How to explore

Use the authorize button inside the interactive reference, inspect request and response models, and try endpoints against the running server.

Open the live OpenAPI spec

Endpoint Reference

An interactive reference powered by Swagger UI and backed by the project OpenAPI specification.

Docs route: /docs