{
  "openapi": "3.1.0",
  "info": {
    "title": "Muhammad Burhan — Portfolio API",
    "description": "Structured API exposing the professional profile, services, skills, certifications, and technology expertise of Muhammad Burhan — freelance software developer and data analytics consultant.",
    "version": "1.0.0",
    "contact": {
      "name": "Muhammad Burhan",
      "email": "the_burhan@hotmail.com",
      "url": "https://www.linkedin.com/in/hiburhan/"
    }
  },
  "servers": [
    {
      "url": "https://muhammadburhan.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/profile.json": {
      "get": {
        "operationId": "getProfile",
        "summary": "Get professional profile",
        "description": "Returns Muhammad Burhan's core professional profile: name, title, bio, contact details, and high-level career stats (years of experience, projects delivered, industries, global delivery regions).",
        "responses": {
          "200": {
            "description": "Profile data",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Profile" }
              }
            }
          }
        }
      }
    },
    "/api/services.json": {
      "get": {
        "operationId": "getServices",
        "summary": "Get service offerings",
        "description": "Returns the list of freelance services offered: E-Commerce Development, MarTech, System Integration, and Technology Consulting.",
        "responses": {
          "200": {
            "description": "Services list",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ServicesResponse" }
              }
            }
          }
        }
      }
    },
    "/api/skills.json": {
      "get": {
        "operationId": "getSkills",
        "summary": "Get skills and interests",
        "description": "Returns skills grouped by category: Solution Architecture, Leadership & Strategy, and Emerging & Data.",
        "responses": {
          "200": {
            "description": "Skills data",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SkillsResponse" }
              }
            }
          }
        }
      }
    },
    "/api/expertise.json": {
      "get": {
        "operationId": "getExpertise",
        "summary": "Get technology expertise and positioning",
        "description": "Returns the technology positioning statement, vendor-independence stance, selection criteria, and broad domains of expertise. Use this to understand Muhammad's approach to technology decisions.",
        "responses": {
          "200": {
            "description": "Expertise and positioning",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Expertise" }
              }
            }
          }
        }
      }
    },
    "/api/certifications.json": {
      "get": {
        "operationId": "getCertifications",
        "summary": "Get professional certifications",
        "description": "Returns all professional certifications grouped by issuer: AWS, Commercetools, and Cognigy.",
        "responses": {
          "200": {
            "description": "Certifications list",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/CertificationsResponse" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Profile": {
        "type": "object",
        "properties": {
          "name": { "type": "string", "example": "Muhammad Burhan" },
          "title": { "type": "string", "example": "Freelance Software Developer & Data Analytics Consultant" },
          "email": { "type": "string", "format": "email" },
          "linkedin": { "type": "string", "format": "uri" },
          "tagline": { "type": "string" },
          "bio": { "type": "string" },
          "stats": {
            "type": "object",
            "properties": {
              "yearsOfExperience": { "type": "integer" },
              "projectsDelivered": { "type": "integer" },
              "industriesSpanned": { "type": "integer" },
              "programsDeliveredValue": { "type": "string" },
              "globalDelivery": { "type": "array", "items": { "type": "string" } },
              "sectors": { "type": "array", "items": { "type": "string" } }
            }
          }
        }
      },
      "Service": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "title": { "type": "string" },
          "description": { "type": "string" }
        }
      },
      "ServicesResponse": {
        "type": "object",
        "properties": {
          "services": { "type": "array", "items": { "$ref": "#/components/schemas/Service" } }
        }
      },
      "SkillGroup": {
        "type": "object",
        "properties": {
          "heading": { "type": "string" },
          "skills": { "type": "array", "items": { "type": "string" } }
        }
      },
      "SkillsResponse": {
        "type": "object",
        "properties": {
          "skillGroups": { "type": "array", "items": { "$ref": "#/components/schemas/SkillGroup" } }
        }
      },
      "Expertise": {
        "type": "object",
        "properties": {
          "positioningStatement": { "type": "string" },
          "vendorStance": { "type": "string" },
          "approachStatement": { "type": "string" },
          "selectionCriteria": { "type": "array", "items": { "type": "string" } },
          "architectureStyle": { "type": "string" },
          "vendorStanceLabel": { "type": "string" },
          "domains": { "type": "array", "items": { "type": "string" } }
        }
      },
      "Credential": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "level": { "type": "string" }
        }
      },
      "CertificationGroup": {
        "type": "object",
        "properties": {
          "issuer": { "type": "string" },
          "credentials": { "type": "array", "items": { "$ref": "#/components/schemas/Credential" } }
        }
      },
      "CertificationsResponse": {
        "type": "object",
        "properties": {
          "certifications": { "type": "array", "items": { "$ref": "#/components/schemas/CertificationGroup" } }
        }
      }
    }
  }
}