{
  "openapi": "3.1.0",
  "info": {
    "title": "Lauro Sport Storefront API",
    "version": "1.0.0",
    "description": "Scopri Lauro Sport: abbigliamento sportivo e streetwear per uomo e donna. T-shirt, felpe, giacche e pantaloni di qualità. Spedizione veloce e resi facili.",
    "contact": {
      "email": "info@lauro.store",
      "url": "https:\/\/www.laurosport.store\/pages\/contact"
    }
  },
  "servers": [
    { "url": "https:\/\/www.laurosport.store" }
  ],
  "x-service-info": {
    "categories": ["commerce", "ecommerce", "ai", "retail"],
    "docs": {
      "homepage": "https:\/\/www.laurosport.store",
      "apiReference": "https:\/\/www.laurosport.store\/agents.md",
      "llms": "https:\/\/www.laurosport.store\/llms.txt"
    }
  },
  "paths": {
    "/api": {
      "get": {
        "operationId": "getApiRoot",
        "summary": "Agent API root",
        "description": "API discovery index with payment and endpoint metadata.",
        "x-payment-info": {
          "offers": [
            {
              "amount": "1000",
              "currency": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
              "description": "Agent API root access",
              "intent": "charge",
              "method": "tempo"
            },
            {
              "amount": "1",
              "currency": "usd",
              "description": "Agent API root access",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        },
        "responses": {
          "200": { "description": "API index JSON" },
          "402": { "description": "Payment Required" }
        }
      }
    },
    "/api/catalog": {
      "get": {
        "operationId": "getCatalog",
        "summary": "Full product catalog",
        "description": "Returns paginated products with variants, pricing, availability, images, SKU and GTIN.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": { "type": "integer", "default": 1 },
            "description": "Page number (250 products per page)"
          }
        ],
        "x-payment-info": {
          "offers": [
            {
              "amount": "1000",
              "currency": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
              "description": "Product catalog API access",
              "intent": "charge",
              "method": "tempo"
            },
            {
              "amount": "1",
              "currency": "usd",
              "description": "Product catalog API access",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Catalog JSON",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/CatalogResponse" }
              }
            }
          },
          "402": { "description": "Payment Required" }
        }
      }
    },
    "/api/search": {
      "get": {
        "operationId": "searchProducts",
        "summary": "Search products",
        "description": "Search by title, brand, category, description and tags.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": { "type": "string" },
            "description": "Search query"
          }
        ],
        "x-payment-info": {
          "offers": [
            {
              "amount": "1000",
              "currency": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
              "description": "Product search API access",
              "intent": "charge",
              "method": "tempo"
            },
            {
              "amount": "1",
              "currency": "usd",
              "description": "Product search API access",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Search results JSON",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponse" }
              }
            }
          },
          "402": { "description": "Payment Required" }
        }
      }
    },
    "/api/products-feed.json": {
      "get": {
        "operationId": "getProductsFeed",
        "summary": "AI-optimized merchant product feed",
        "x-payment-info": {
          "offers": [
            {
              "amount": "1000",
              "currency": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
              "description": "AI products feed access",
              "intent": "charge",
              "method": "tempo"
            },
            {
              "amount": "1",
              "currency": "usd",
              "description": "AI products feed access",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Product feed JSON",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ProductsFeed" }
              }
            }
          },
          "402": { "description": "Payment Required" }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Product": {
        "type": "object",
        "properties": {
          "id": { "type": "integer" },
          "handle": { "type": "string" },
          "title": { "type": "string" },
          "description": { "type": "string" },
          "brand": { "type": "string" },
          "category": { "type": "string" },
          "price": { "type": "number" },
          "compare_at_price": { "type": ["number", "null"] },
          "currency": { "type": "string" },
          "available": { "type": "boolean" },
          "availability": { "type": "string", "enum": ["in_stock", "out_of_stock"] },
          "url": { "type": "string", "format": "uri" },
          "sku": { "type": "string" },
          "gtin": { "type": "string" },
          "images": { "type": "array", "items": { "type": "string", "format": "uri" } },
          "variants": { "type": "array", "items": { "$ref": "#/components/schemas/Variant" } }
        }
      },
      "Variant": {
        "type": "object",
        "properties": {
          "id": { "type": "integer" },
          "sku": { "type": "string" },
          "barcode": { "type": "string" },
          "price": { "type": "number" },
          "available": { "type": "boolean" }
        }
      },
      "CatalogResponse": {
        "type": "object",
        "properties": {
          "api": { "type": "string" },
          "total_products": { "type": "integer" },
          "products": { "type": "array", "items": { "$ref": "#/components/schemas/Product" } }
        }
      },
      "SearchResponse": {
        "type": "object",
        "properties": {
          "query": { "type": "string" },
          "results_count": { "type": "integer" },
          "results": { "type": "array", "items": { "$ref": "#/components/schemas/Product" } }
        }
      },
      "ProductsFeed": {
        "type": "object",
        "properties": {
          "items": { "type": "array", "items": { "type": "object" } }
        }
      }
    }
  },
  "x-discovery": {
    "llmsTxt": "https:\/\/www.laurosport.store\/llms.txt",
    "agentsMd": "https:\/\/www.laurosport.store\/agents.md",
    "apiCatalog": "https:\/\/www.laurosport.store\/.well-known\/api-catalog",
    "mcpServerCard": "https:\/\/www.laurosport.store\/.well-known\/mcp\/server-card.json",
    "paymentProtocols": ["mpp", "x402"]
  }
}