{
  "openapi": "3.1.0",
  "info": {
    "title": "SilarAI Smart Commerce & Knowledge Graph API",
    "version": "3.2.0",
    "description": "Public discovery, RAG context retrieval, site architecture, and semantic knowledge endpoints for LLMs, AI agents, and search engines.",
    "contact": {
      "name": "SilarAI API Support",
      "email": "info@silarai.com",
      "url": "https://silarai.com"
    },
    "license": {
      "name": "Proprietary / Open Discovery",
      "url": "https://silarai.com"
    }
  },
  "servers": [
    {
      "url": "https://silarai.com",
      "description": "Production Global Ingress"
    }
  ],
  "paths": {
    "/ai/rag-chunks.json": {
      "get": {
        "summary": "Retrieve chunked RAG knowledge context",
        "description": "Returns high-density chunked knowledge objects with vector-friendly metadata, confidence scores, and canonical citation backlinks.",
        "operationId": "getRagContext",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "description": "Optional query filter (e.g., \"shopping assistant\", \"b2b pricing\", \"d2c\")",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Structured RAG knowledge chunks and semantic backlink graph",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/ai/geo-knowledge.json": {
      "get": {
        "summary": "Generative Engine Optimization (GEO) Knowledge Graph",
        "description": "Returns 10-cluster keyword taxonomy, 15 GEO definition blocks, and authoritative citations for AI search engines.",
        "operationId": "getGeoKnowledge",
        "responses": {
          "200": {
            "description": "GEO Knowledge blocks and entity taxonomies",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/ai/d2c-knowledge-graph.json": {
      "get": {
        "summary": "Direct D2C Brand Knowledge Graph & Cypher Ontology",
        "description": "Returns 4-pillar, 16-node D2C knowledge graph, Cypher graph DB schema, and Schema.org DefinedTermSet.",
        "operationId": "getD2cKnowledgeGraph",
        "responses": {
          "200": {
            "description": "D2C Knowledge Graph definition",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/ai/site-architecture.json": {
      "get": {
        "summary": "Structured Site Architecture and Topic Pillars",
        "description": "Returns all 9 product pillars, 11 industry verticals, and 2 platform integrations with canonical URLs.",
        "operationId": "getSiteArchitecture",
        "responses": {
          "200": {
            "description": "Site architecture tree",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/ai/aeo-faq.json": {
      "get": {
        "summary": "AEO and AIO Question & Answer Repository",
        "description": "Direct, concise question-answer pairs optimized for AI Overviews and answer engines.",
        "operationId": "getAeoFaq",
        "responses": {
          "200": {
            "description": "AEO FAQ library",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/ai/discovery.json": {
      "get": {
        "summary": "Master AI Discovery Hub",
        "description": "Central discovery index linking all LLM, RAG, GEO, AEO, and OpenAPI documentation endpoints.",
        "operationId": "getAiDiscoveryHub",
        "responses": {
          "200": {
            "description": "AI discovery index",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}