{
  "openapi": "3.1.0",
  "info": {
    "title": "Debesh Ghorui Portfolio API",
    "version": "1.0.0",
    "description": "Read-only public portfolio data for Debesh Ghorui: profile, projects, stack, timeline, and contact. No API key. No request body."
  },
  "servers": [
    {
      "url": "https://debeshghorui.dev"
    }
  ],
  "paths": {
    "/api/portfolio.json": {
      "get": {
        "summary": "Portfolio data",
        "description": "Returns the public profile, projects, stack, timeline, and contact details shown on the homepage.",
        "operationId": "getPortfolio",
        "responses": {
          "200": {
            "description": "Profile, projects, stack, timeline, and contact details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "name",
                    "url",
                    "email",
                    "bio",
                    "projects",
                    "stack"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "handle": {
                      "type": "string"
                    },
                    "email": {
                      "type": "string",
                      "format": "email"
                    },
                    "tagline": {
                      "type": "string"
                    },
                    "bio": {
                      "type": "string"
                    },
                    "badges": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "socials": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "label",
                          "href"
                        ],
                        "properties": {
                          "label": {
                            "type": "string"
                          },
                          "href": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "projects": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "name",
                          "description",
                          "href",
                          "stack"
                        ],
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "tag": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "href": {
                            "type": "string"
                          },
                          "stack": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "stack": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "timeline": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "when",
                          "title",
                          "place",
                          "detail"
                        ],
                        "properties": {
                          "when": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "place": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "The path is not a portfolio API route.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "title",
                    "status",
                    "detail",
                    "code",
                    "resolution"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "RFC 9457 problem type URI."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable error code."
                    },
                    "resolution": {
                      "type": "string",
                      "description": "What the caller should do next."
                    }
                  }
                }
              }
            }
          },
          "405": {
            "description": "The method is not GET or HEAD.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "title",
                    "status",
                    "detail",
                    "code",
                    "resolution"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "RFC 9457 problem type URI."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable error code."
                    },
                    "resolution": {
                      "type": "string",
                      "description": "What the caller should do next."
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "summary": "Health check",
        "description": "Returns whether the read-only portfolio API is responding.",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "The API is up.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "const": "ok"
                    }
                  },
                  "required": [
                    "status"
                  ]
                }
              }
            }
          },
          "404": {
            "description": "The path is not a portfolio API route.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "title",
                    "status",
                    "detail",
                    "code",
                    "resolution"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "RFC 9457 problem type URI."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable error code."
                    },
                    "resolution": {
                      "type": "string",
                      "description": "What the caller should do next."
                    }
                  }
                }
              }
            }
          },
          "405": {
            "description": "The method is not GET or HEAD.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "title",
                    "status",
                    "detail",
                    "code",
                    "resolution"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "RFC 9457 problem type URI."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable error code."
                    },
                    "resolution": {
                      "type": "string",
                      "description": "What the caller should do next."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
