{
  "openapi": "3.1.0",
  "info": {
    "title": "dlgrv.com content catalogs",
    "version": "1.0.0",
    "summary": "Read-only static JSON catalogs for the personal site dlgrv.com",
    "description": "dlgrv.com is a personal portfolio / art-space. These endpoints are static files, not an application backend. There is no authentication, no write API, and no MCP server on this domain.",
    "contact": {
      "name": "Leonid Dolgirev (dlgrv)",
      "url": "https://dlgrv.com/contact/",
      "email": "dolgirevleonid@gmail.com"
    },
    "license": {
      "name": "Personal site content",
      "url": "https://dlgrv.com/privacy/"
    }
  },
  "servers": [
    {
      "url": "https://dlgrv.com",
      "description": "Static origin (Cloudflare Pages)"
    }
  ],
  "tags": [
    {
      "name": "content",
      "description": "Read-only catalogs for blog posts and photo albums"
    }
  ],
  "paths": {
    "/blog/index.json": {
      "get": {
        "operationId": "listBlogPosts",
        "summary": "List blog post metadata",
        "description": "Returns a JSON array of published blog posts (slug, title, date, excerpt). Empty array means no posts yet.",
        "tags": ["content"],
        "responses": {
          "200": {
            "description": "Blog post catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BlogPost"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/photos/manifest.json": {
      "get": {
        "operationId": "listPhotoTrips",
        "summary": "List photo album trips",
        "description": "Returns the top-level photo trips catalog used by the desktop Photos app.",
        "tags": ["content"],
        "responses": {
          "200": {
            "description": "Photo trips catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PhotoTrip"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/photos/{trip}/manifest.json": {
      "get": {
        "operationId": "getPhotoTripManifest",
        "summary": "Get photos for one trip",
        "description": "Returns the per-trip photo manifest (filenames and captions) for a trip id from the top-level catalog.",
        "tags": ["content"],
        "parameters": [
          {
            "name": "trip",
            "in": "path",
            "required": true,
            "description": "Trip id from /photos/manifest.json (for example murmansk).",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Trip photo manifest",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TripManifest"
                }
              }
            }
          },
          "404": {
            "description": "Unknown trip id — static host returns HTML/markdown 404, not a JSON error body (no application backend)."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BlogPost": {
        "type": "object",
        "additionalProperties": false,
        "required": ["slug", "title", "date", "readingTime", "excerpt"],
        "properties": {
          "slug": { "type": "string" },
          "title": { "type": "string" },
          "date": { "type": "string", "format": "date" },
          "readingTime": { "type": "integer", "minimum": 1 },
          "excerpt": { "type": "string" },
          "cover": { "type": "string" }
        }
      },
      "LocalizedString": {
        "type": "object",
        "additionalProperties": false,
        "required": ["en", "ru"],
        "properties": {
          "en": { "type": "string" },
          "ru": { "type": "string" }
        }
      },
      "PhotoTrip": {
        "type": "object",
        "additionalProperties": true,
        "required": ["id", "title", "year", "thumb", "count"],
        "properties": {
          "id": { "type": "string" },
          "title": { "$ref": "#/components/schemas/LocalizedString" },
          "year": { "type": "string" },
          "thumb": { "type": "string" },
          "count": { "type": "integer", "minimum": 0 }
        }
      },
      "TripManifest": {
        "type": "object",
        "additionalProperties": true,
        "description": "Per-trip photo listing used by the Photos window"
      }
    }
  }
}