{
  "openapi": "3.1.0",
  "info": {
    "title": "Awamer AI Platform",
    "description": "Arabic-first AI tools platform. Provides 50+ AI-powered tools for writing, design, business analysis, legal, medical, and creative content in Arabic and English.",
    "version": "1.0.0",
    "contact": {
      "name": "Awamer Support",
      "email": "support@awamer.ai",
      "url": "https://awamer.ai/ar/contact-us"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://awamer.ai/ar"
    },
    "x-logo": {
      "url": "https://awamer.ai/logo.png",
      "altText": "أوامر - Awamer AI"
    }
  },
  "servers": [
    {
      "url": "https://awamer.ai",
      "description": "Production server"
    }
  ],
  "tags": [
    { "name": "discovery",    "description": "Agent and API discovery endpoints" },
    { "name": "sitemap",      "description": "Site navigation and content index" },
    { "name": "content",      "description": "LLM-readable site content" },
    { "name": "tools",        "description": "Free AI tools (web interface)" },
    { "name": "pro-tools",    "description": "Pro AI tools for enterprise (web interface)" }
  ],
  "paths": {
    "/llms.txt": {
      "get": {
        "tags": ["content"],
        "summary": "LLM content index",
        "description": "Concise markdown index of all site pages and tools — optimised for LLM consumption (llmstxt.org standard).",
        "operationId": "getLlmsTxt",
        "responses": {
          "200": {
            "description": "Markdown content index",
            "content": { "text/plain": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "tags": ["content"],
        "summary": "Full LLM content",
        "description": "Comprehensive markdown content with detailed descriptions of every tool and page — for deep LLM understanding.",
        "operationId": "getLlmsFullTxt",
        "responses": {
          "200": {
            "description": "Full markdown content",
            "content": { "text/plain": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "tags": ["sitemap"],
        "summary": "Sitemap index",
        "description": "XML sitemap index referencing all sub-sitemaps (pages, tools, pro tools).",
        "operationId": "getSitemapIndex",
        "responses": {
          "200": {
            "description": "Sitemap index XML",
            "content": { "application/xml": { "schema": { "type": "string" } } }
          }
        }
      }
    },
    "/sitemap-pages.xml": {
      "get": {
        "tags": ["sitemap"],
        "summary": "Pages sitemap",
        "description": "XML sitemap for all static pages with hreflang alternates.",
        "operationId": "getSitemapPages",
        "responses": {
          "200": { "description": "Pages sitemap XML", "content": { "application/xml": { "schema": { "type": "string" } } } }
        }
      }
    },
    "/sitemap-tools.xml": {
      "get": {
        "tags": ["sitemap"],
        "summary": "Free tools sitemap",
        "description": "XML sitemap for all 36 free AI tools with OG images and hreflang.",
        "operationId": "getSitemapTools",
        "responses": {
          "200": { "description": "Tools sitemap XML", "content": { "application/xml": { "schema": { "type": "string" } } } }
        }
      }
    },
    "/sitemap-pro.xml": {
      "get": {
        "tags": ["sitemap"],
        "summary": "Pro tools sitemap",
        "description": "XML sitemap for all 17 Pro AI tools.",
        "operationId": "getSitemapPro",
        "responses": {
          "200": { "description": "Pro sitemap XML", "content": { "application/xml": { "schema": { "type": "string" } } } }
        }
      }
    },
    "/sitemap.txt": {
      "get": {
        "tags": ["sitemap"],
        "summary": "Plain-text sitemap",
        "description": "All canonical URLs as plain text, one per line.",
        "operationId": "getSitemapTxt",
        "responses": {
          "200": { "description": "URL list", "content": { "text/plain": { "schema": { "type": "string" } } } }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "tags": ["discovery"],
        "summary": "API catalog (RFC 9727)",
        "description": "Returns a linkset+json document describing available APIs per RFC 9727.",
        "operationId": "getApiCatalog",
        "responses": {
          "200": {
            "description": "API linkset",
            "content": { "application/linkset+json": { "schema": { "type": "object" } } }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "tags": ["discovery"],
        "summary": "Agent skills index",
        "description": "Agent Skills Discovery index per cloudflare/agent-skills-discovery-rfc v0.2.0.",
        "operationId": "getAgentSkills",
        "responses": {
          "200": { "description": "Agent skills JSON", "content": { "application/json": { "schema": { "type": "object" } } } }
        }
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "tags": ["discovery"],
        "summary": "MCP server card (SEP-1649)",
        "description": "Model Context Protocol server metadata card.",
        "operationId": "getMcpServerCard",
        "responses": {
          "200": { "description": "MCP server card JSON", "content": { "application/json": { "schema": { "type": "object" } } } }
        }
      }
    },
    "/.well-known/openid-configuration": {
      "get": {
        "tags": ["discovery"],
        "summary": "OpenID Connect discovery",
        "description": "OIDC provider metadata per OpenID Connect Discovery 1.0.",
        "operationId": "getOidcConfig",
        "responses": {
          "200": { "description": "OIDC configuration JSON", "content": { "application/json": { "schema": { "type": "object" } } } }
        }
      }
    },
    "/.well-known/oauth-protected-resource": {
      "get": {
        "tags": ["discovery"],
        "summary": "OAuth Protected Resource Metadata (RFC 9728)",
        "operationId": "getOauthResource",
        "responses": {
          "200": { "description": "Resource metadata JSON", "content": { "application/json": { "schema": { "type": "object" } } } }
        }
      }
    },
    "/.well-known/ai-plugin.json": {
      "get": {
        "tags": ["discovery"],
        "summary": "AI plugin manifest",
        "description": "Plugin manifest for AI assistant integration (ChatGPT plugin format).",
        "operationId": "getAiPlugin",
        "responses": {
          "200": { "description": "Plugin manifest JSON", "content": { "application/json": { "schema": { "type": "object" } } } }
        }
      }
    },
    "/.well-known/security.txt": {
      "get": {
        "tags": ["discovery"],
        "summary": "Security contact (RFC 9116)",
        "operationId": "getSecurityTxt",
        "responses": {
          "200": { "description": "Security policy text", "content": { "text/plain": { "schema": { "type": "string" } } } }
        }
      }
    },
    "/ar/tools/{slug}": {
      "get": {
        "tags": ["tools"],
        "summary": "Free AI tool (Arabic)",
        "description": "Interactive AI tool page. Returns HTML by default; returns text/markdown when Accept: text/markdown is sent. Each tool generates a ready-to-use AI prompt.",
        "operationId": "getFreeTool",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Tool identifier",
            "schema": {
              "type": "string",
              "enum": [
                "ad-campaign","ai-detector","ai-humanizer","ai-prompt-checker",
                "arabic-calligraphy","business-model","competitor-analysis","cv-builder",
                "data-analysis","educational-content","eid-greeting-cardr","file-analysis",
                "food-dish-analyzer","football-match-analyzer","game-design","greeting-card",
                "job-description","legal-contract-review","marketing-strategy",
                "medical-decision-assistant","medical-diagnosis-assistant","mobile-app-design",
                "nda-agreement","personal-perfume-creator","photo-creation","photo-recreation",
                "podcast-creation","presentation-creation","product-packaging-innovator",
                "project-plan","research-paper","script-writing","user-manual",
                "video-creation","website-design","writing"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Tool page",
            "headers": {
              "Link": { "schema": { "type": "string" }, "description": "RFC 8288 agent discovery links" },
              "Vary": { "schema": { "type": "string" }, "description": "Accept" }
            },
            "content": {
              "text/html": { "schema": { "type": "string" } },
              "text/markdown": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/ar/pro/tools/{slug}": {
      "get": {
        "tags": ["pro-tools"],
        "summary": "Pro AI tool (Arabic)",
        "description": "Enterprise-grade AI tool page for business use cases.",
        "operationId": "getProTool",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Pro tool identifier",
            "schema": {
              "type": "string",
              "enum": [
                "credit-scoring","demand-forecasting","diagnostic-assistance","drug-discovery",
                "dynamic-pricing","financial-forecasting","fraud-detection","lead-scoring",
                "personalized-recommendations","predictive-maintenance","production-scheduling",
                "quality-control","resource-optimization","route-optimization","rpa-automation",
                "threat-detection","visual-content-prompt-builder"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pro tool page",
            "content": {
              "text/html": { "schema": { "type": "string" } },
              "text/markdown": { "schema": { "type": "string" } }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {},
    "securitySchemes": {}
  },
  "x-agent-capabilities": {
    "markdown-negotiation": true,
    "link-headers": true,
    "agent-skills": "https://awamer.ai/.well-known/agent-skills/index.json",
    "mcp-server-card": "https://awamer.ai/.well-known/mcp/server-card.json",
    "primary-language": "ar",
    "supported-languages": ["ar", "en"]
  }
}