{
  "openapi": "3.0.3",
  "info": {
    "title": "K-Beauty Bangladesh Public Storefront REST API",
    "description": "Public storefront APIs to list and search authentic Korean skincare products, categories, and brands.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://kbeauty.bd/api/v1",
      "description": "Production Public API Server"
    }
  ],
  "paths": {
    "/products": {
      "get": {
        "summary": "List or search products",
        "description": "Fetch a list of active storefront products with optional pagination and filters.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": { "type": "integer", "default": 1 },
            "required": false
          },
          {
            "name": "category_id",
            "in": "query",
            "schema": { "type": "integer" },
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/categories": {
      "get": {
        "summary": "List categories",
        "description": "Fetch a nested list of product categories.",
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    }
  }
}