Quickstart Guide

Get started with the ModestWear API in 5 minutes.

Base URL

Production: https://modestwear.onrender.com
Development: http://localhost:8000

Authentication

All authenticated endpoints require a JWT token in the Authorization header:

Authorization: Bearer <your_access_token>

Quick Example

1. Register a New User

curl -X POST https://modestwear.onrender.com/api/users/register/ \
  -H "Content-Type: application/json" \
  -d '{
    "email": "sarah@example.com",
    "password": "SecurePass123!",
    "full_name": "Sarah Ahmed"
  }'

Response:

{
  "success": true,
  "data": {
    "user": {
      "id": 1,
      "email": "sarah@example.com",
      "username": "sarah",
      "first_name": "Sarah",
      "last_name": "Ahmed"
    },
    "tokens": {
      "access_token": "eyJ0eXAiOiJKV1QiLCJhbGc...",
      "refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGc...",
      "token_type": "Bearer",
      "expires_in": 900
    }
  }
}

2. Browse Products

curl https://modestwear.onrender.com/api/catalog/products/

3. Filter by Coverage Level

curl "https://modestwear.onrender.com/api/catalog/products/?coverage_level=full&category=dresses"

4. Add to Cart

curl -X POST https://modestwear.onrender.com/api/orders/cart/add/ \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "variant_id": 5,
    "quantity": 2
  }'

Interactive Documentation

Try all endpoints interactively at:

Swagger UI: https://modestwear.onrender.com/docs/
ReDoc: https://modestwear.onrender.com/redoc/

Next Steps