{
  "openapi": "3.1.0",
  "info": {
    "title": "Deian Isac Public API",
    "version": "1.0.0",
    "description": "A read-only API for Deian Isac's public person record, projects, writing, appearances, and website world.",
    "contact": {
      "url": "https://deianisac.com/"
    }
  },
  "servers": [
    {
      "url": "https://deianisac.com"
    }
  ],
  "paths": {
    "/api/v1/me.json": {
      "get": {
        "operationId": "getMe",
        "summary": "Get Deian's public person record",
        "description": "Person record",
        "responses": {
          "200": {
            "description": "A versioned JSON document.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/projects.json": {
      "get": {
        "operationId": "getProjects",
        "summary": "List public projects",
        "description": "Project collection",
        "responses": {
          "200": {
            "description": "A versioned JSON document.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/posts.json": {
      "get": {
        "operationId": "getPosts",
        "summary": "List published field notes",
        "description": "Post collection",
        "responses": {
          "200": {
            "description": "A versioned JSON document.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/content.json": {
      "get": {
        "operationId": "getContent",
        "summary": "List podcasts, profiles, and external writing",
        "description": "Content collection",
        "responses": {
          "200": {
            "description": "A versioned JSON document.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/world.json": {
      "get": {
        "operationId": "getWorld",
        "summary": "Get the site's navigable world map",
        "description": "World record",
        "responses": {
          "200": {
            "description": "A versioned JSON document.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Envelope": {
        "type": "object",
        "required": [
          "apiVersion",
          "generatedAt",
          "data",
          "links"
        ],
        "properties": {
          "apiVersion": {
            "type": "string",
            "const": "1.0"
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "data": {},
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "links": {
            "type": "object",
            "required": [
              "self",
              "documentation",
              "openapi"
            ],
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            }
          }
        }
      }
    }
  }
}
