> For the complete documentation index, see [llms.txt](https://docs.e-commerce-api.deephiwase.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.e-commerce-api.deephiwase.xyz/readme.md).

# Introduction

## DOCUMENTATION & SWAGGER API

Welcome to the E-Commerce API documentation!

## Base URL

All API endpoints are relative to the following base URL: /api/v1

For example, the user registration endpoint is `/api/v1/auth/register`.

## Overview

* **API Version:** 1.0.0
* **Authentication:** Cookie base auth with access token and refresh token.
* **Authorization:** Role-based access control ('admin', 'customer', 'retailer'). Specific roles are required for certain endpoints.
* **Rate Limiting:** Applied globally (60 requests per minute per IP). Exceeding the limit returns a `429 Too Many Requests` error.
* **Input Validation:** Uses `zod`. Invalid requests return detailed `400 Bad Request` errors.
* **Content Format:** Primarily JSON (`application/json`). File uploads use `multipart/form-data`.