{
  "openapi": "3.1.0",
  "info": {
    "title": "AICEO SmartWell Health API",
    "description": "Global AI Discovery API for AICEO SmartWell. Exposes TCM core competencies including AI Four-Diagnosis, Constitution Assessment, Medicinal-Diet Recipes, 24 Solar Terms Health, and Digital Business Cards to global AI models (ChatGPT, Claude, Gemini, etc.).",
    "version": "2.0.0",
    "contact": {
      "name": "AICEO Support",
      "url": "https://aiceo.hk",
      "email": "support@aiceo.hk"
    }
  },
  "servers": [
    {
      "url": "https://aiceo.hk/api/v2",
      "description": "AICEO Global Production API"
    }
  ],
  "paths": {
    "/tcm/four-diagnosis": {
      "post": {
        "summary": "AI Four-Diagnosis (Tongue/Face/Palm/Eye)",
        "operationId": "analyzeFourDiagnosis",
        "tags": ["TCM Diagnosis"],
        "description": "Analyzes user's tongue, face, palm, and eye images to provide a comprehensive Traditional Chinese Medicine diagnostic report."
      }
    },
    "/tcm/constitution": {
      "post": {
        "summary": "TCM Constitution Assessment",
        "operationId": "assessConstitution",
        "tags": ["Health Assessment"],
        "description": "Evaluates the user's TCM constitution based on the GB/T46939-2025 standard (9 constitution types)."
      }
    },
    "/zhishan/recipe": {
      "post": {
        "summary": "AI Medicinal-Diet Recipe Generation",
        "operationId": "generateYaoshanRecipe",
        "tags": ["Nutrition", "ZhiShan"],
        "description": "Generates personalized TCM medicinal-diet (yaoshan) recipes based on the user's constitution and royal dietary standards."
      }
    },
    "/health/solar-terms": {
      "get": {
        "summary": "24 Solar Terms Health Guidance",
        "operationId": "getSolarTermsGuidance",
        "tags": ["Wellness"],
        "description": "Provides health preservation and wellness guidance according to the current or specified TCM 24 solar term."
      }
    },
    "/business/card": {
      "get": {
        "summary": "Retrieve Digital Business Card",
        "operationId": "getDigitalCard",
        "tags": ["Networking"],
        "description": "Fetches the AICEO digital business card information for a specified user or organization."
      }
    }
  }
}