{
  "schema_version": "1.0",
  "name": "aectec",
  "description": "UK-based online store for technology components — laptops, desktops, networking, storage, and more. Products from UK distributors, delivered across the UK. All paths in this document are relative to the origin this file is served from.",
  "capabilities": {
    "search": {
      "endpoint": "/api/products/search",
      "method": "GET",
      "description": "Keyword product search over the live catalogue. Returns JSON: { hits, found, facet_counts }.",
      "parameters": {
        "q": { "type": "string", "required": false, "description": "Search query (max 200 chars). Omit to list all products." },
        "page": { "type": "integer", "required": false, "description": "Page number, 1-indexed (default 1)" },
        "per_page": { "type": "integer", "required": false, "description": "Results per page, 1-48 (default 24)" },
        "brand": { "type": "string", "required": false, "description": "Filter by exact brand name" },
        "category_id": { "type": "integer", "required": false, "description": "Filter by numeric category id (bigint; department nodes carry a negative synthetic id)" },
        "in_stock": { "type": "boolean", "required": false, "description": "Pass true to return only in-stock items" },
        "min_price": { "type": "number", "required": false, "description": "Minimum price in GBP (VAT-inclusive)" },
        "max_price": { "type": "number", "required": false, "description": "Maximum price in GBP (VAT-inclusive)" },
        "region": { "type": "string", "required": false, "enum": ["UK", "EU"], "description": "Catalogue availability bucket: UK = full catalogue, EU = the subset deliverable to the EU. Defaults to the visitor's geo, else UK." },
        "sort_by": { "type": "string", "required": false, "enum": ["_text_match:desc,created_at:desc", "created_at:desc", "created_at:asc", "sell_price:asc", "sell_price:desc", "name:asc", "name:desc"], "description": "Sort order (default: relevance, then newest)" }
      },
      "rate_limit": "60 requests/minute per IP",
      "response_format": "application/json"
    }
  },
  "checkout": {
    "api": null,
    "note": "There is no programmatic cart or checkout API. Purchasing is a browser flow: add to cart on a product page, then pay via Stripe hosted checkout."
  },
  "structured_data": {
    "format": "JSON-LD",
    "vocabulary": "https://schema.org",
    "types_used": ["Product", "Offer", "Organization", "WebSite", "ItemList", "BreadcrumbList"],
    "location": "Embedded on the homepage and on every product detail page (/products/{slug})"
  },
  "sitemap": "/sitemap.xml",
  "pricing": {
    "currency": "GBP",
    "note": "GBP is the only supported currency. Displayed prices include UK VAT."
  },
  "contact": {
    "support_email": "sebs@aec600.co.uk"
  }
}