{
  "openapi": "3.1.0",
  "info": {
    "title": "Mylne Public API",
    "version": "1.0.0",
    "description": "Read-only API-key access to the Alfred Mylne & Co. yacht and design archive.",
    "contact": {
      "name": "A. Mylne & Co.",
      "email": "david@mylne.com",
      "url": "https://www.mylne.com/"
    }
  },
  "servers": [
    {
      "url": "https://api.mylne.com"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Create a personal key at https://api.mylne.com/keys."
      }
    }
  },
  "paths": {
    "/v1/yachts": {
      "get": {
        "summary": "List yachts",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year_built",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "exists_status",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "design_id",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 30,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of yachts"
          }
        }
      }
    },
    "/v1/yachts/{slug}": {
      "get": {
        "summary": "Get yacht detail",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Yacht detail"
          },
          "404": {
            "description": "Yacht not found"
          }
        }
      }
    },
    "/v1/yachts/{slug}/owners": {
      "get": {
        "summary": "List ownership history (Withheld when consent missing)",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/yachts/{slug}/photos": {
      "get": {
        "summary": "List yacht photos",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/designs": {
      "get": {
        "summary": "List designs",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year_of_design",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "yacht_type_id",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 1
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 30,
              "maximum": 100
            }
          }
        ]
      }
    },
    "/v1/designs/{number}": {
      "get": {
        "summary": "Get design detail by design number",
        "parameters": [
          {
            "name": "number",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ]
      }
    },
    "/v1/designs/{number}/yachts": {
      "get": {
        "summary": "List yachts built to this design",
        "parameters": [
          {
            "name": "number",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ]
      }
    },
    "/v1/designs/{number}/drawings": {
      "get": {
        "summary": "List public-thumbnail drawings",
        "parameters": [
          {
            "name": "number",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ]
      }
    },
    "/v1/recent-activity": {
      "get": {
        "summary": "Unified activity feed",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 30,
              "maximum": 100
            }
          },
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ]
      }
    }
  }
}