openapi: 3.1.0
info:
  title: Kartikey Sharma Portfolio & Developer API
  version: 1.0.0
  description: Official machine-readable developer API for Kartikey Sharma (@kartikeysharmaks) — Software Engineer & Travel Creator. Designed for AI agents, LLMs, function calling, and automated developer tooling.
  contact:
    name: Kartikey Sharma
    email: kartikeysharma1616@gmail.com
    url: https://www.kartikeysharmaks.in/
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://www.kartikeysharmaks.in
    description: Canonical Production Server
paths:
  /api/profile:
    get:
      operationId: getProfile
      summary: Retrieve complete verified developer profile
      description: Returns the complete profile of Kartikey Sharma, including full bio, contact details, categorized technical skills, social profiles, and travel content focus.
      responses:
        '200':
          description: Full developer profile successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Profile'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/skills:
    get:
      operationId: getSkills
      summary: Retrieve categorized technical skills
      description: Returns categorized programming languages, frontend libraries, backend technologies, databases, and DevOps tools mastered by Kartikey Sharma.
      responses:
        '200':
          description: Technical skills list retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Skills'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/projects:
    get:
      operationId: getProjects
      summary: Retrieve featured software engineering projects
      description: Returns a list of production web applications, open-source repositories, and client projects built by Kartikey Sharma.
      responses:
        '200':
          description: Projects list retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectsList'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/contact:
    get:
      operationId: getContactInfo
      summary: Retrieve official contact channels and social profiles
      description: Returns official email address, physical location, and verified profile URLs across GitHub, LinkedIn, Instagram, and Twitter/X.
      responses:
        '200':
          description: Contact information retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Contact'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/travel:
    get:
      operationId: getTravelInfo
      summary: Retrieve travel content creator portfolio and destinations
      description: Returns travel destinations documented by Kartikey Sharma across Uttarakhand and India, including media channels and photography topics.
      responses:
        '200':
          description: Travel creator portfolio retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Travel'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Profile:
      type: object
      required: [name, handle, title, website, email, skills, social]
      properties:
        name:
          type: string
          example: Kartikey Sharma
        handle:
          type: string
          example: '@kartikeysharmaks'
        title:
          type: string
          example: Software Engineer & Travel Content Creator
        website:
          type: string
          format: uri
          example: https://www.kartikeysharmaks.in/
        email:
          type: string
          format: email
          example: kartikeysharma1616@gmail.com
        bio:
          type: string
        skills:
          $ref: '#/components/schemas/Skills'
        social:
          $ref: '#/components/schemas/SocialProfiles'
    Skills:
      type: object
      required: [languages, frontend, backend, tools]
      properties:
        languages:
          type: array
          items:
            type: string
        frontend:
          type: array
          items:
            type: string
        backend:
          type: array
          items:
            type: string
        tools:
          type: array
          items:
            type: string
    ProjectsList:
      type: object
      required: [projects]
      properties:
        projects:
          type: array
          items:
            type: object
            required: [title, description, technologies]
            properties:
              title:
                type: string
              description:
                type: string
              technologies:
                type: array
                items:
                  type: string
              projectUrl:
                type: string
                format: uri
              codeUrl:
                type: string
                format: uri
    Contact:
      type: object
      required: [email, location, social]
      properties:
        email:
          type: string
          format: email
          example: kartikeysharma1616@gmail.com
        location:
          type: object
          required: [city, state, country, postalCode]
          properties:
            city:
              type: string
              example: Haridwar
            state:
              type: string
              example: Uttarakhand
            country:
              type: string
              example: India
            postalCode:
              type: string
              example: '249401'
        social:
          $ref: '#/components/schemas/SocialProfiles'
    SocialProfiles:
      type: object
      properties:
        github:
          type: string
          format: uri
        linkedin:
          type: string
          format: uri
        instagram:
          type: string
          format: uri
        youtube:
          type: string
          format: uri
        twitter:
          type: string
          format: uri
    Travel:
      type: object
      required: [regions, destinations, topics]
      properties:
        regions:
          type: array
          items:
            type: string
        destinations:
          type: array
          items:
            type: string
        topics:
          type: array
          items:
            type: string
    ErrorResponse:
      type: object
      required: [error]
      properties:
        error:
          type: object
          required: [code, message, status, resolution]
          properties:
            code:
              type: string
              enum: [not_found, bad_request, method_not_allowed, internal_error]
              example: not_found
            message:
              type: string
              example: The requested API endpoint was not found.
            status:
              type: integer
              example: 404
            resolution:
              type: string
              example: Check the OpenAPI specification at https://www.kartikeysharmaks.in/openapi.json or consult https://www.kartikeysharmaks.in/developers/.