{
  "openapi": "3.1.0",
  "info": {
    "title": "NamshiCodes Public API",
    "description": "Access verified Namshi coupon codes, stores, articles, and categories for Gulf countries.",
    "version": "1.0.0",
    "contact": {
      "name": "NamshiCodes",
      "url": "https://codesnamshi.com",
      "email": "contact@codesnamshi.com"
    }
  },
  "servers": [
    {
      "url": "https://rmdzplntuanzidcwbhjy.supabase.co/functions/v1",
      "description": "Production API"
    }
  ],
  "paths": {
    "/public-api": {
      "get": {
        "operationId": "getCoupons",
        "summary": "Get active coupon codes",
        "description": "Returns all active, verified Namshi coupon codes with discount details, countries, and categories.",
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "description": "Resource type: coupons, stores, articles, categories, stats",
            "schema": { "type": "string", "enum": ["coupons", "stores", "articles", "categories", "stats"], "default": "coupons" }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Filter by country code (SA, AE, KW, QA, BH, OM)",
            "schema": { "type": "string" }
          },
          {
            "name": "category",
            "in": "query",
            "description": "Filter by category (fashion, shoes, bags, beauty, sport, kids, accessories)",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response with coupon data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": { "type": "string", "description": "The coupon/promo code" },
                          "discount": { "type": "number", "description": "Discount amount" },
                          "discount_type": { "type": "string", "enum": ["percent", "fixed"] },
                          "title": { "type": "string" },
                          "title_ar": { "type": "string" },
                          "countries": { "type": "array", "items": { "type": "string" } },
                          "category": { "type": "string" },
                          "is_hot": { "type": "boolean" },
                          "is_exclusive": { "type": "boolean" },
                          "verified_date": { "type": "string", "format": "date" },
                          "expiry_date": { "type": "string", "format": "date", "nullable": true }
                        }
                      }
                    },
                    "total": { "type": "integer" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/dynamic-llms": {
      "get": {
        "operationId": "getLlmsFullText",
        "summary": "Get full LLM-optimized text database",
        "description": "Returns a complete, auto-generated text representation of all active coupons, articles, stores, and categories optimized for LLM consumption.",
        "responses": {
          "200": {
            "description": "Plain text database",
            "content": {
              "text/plain": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    }
  }
}