Everything you can ask for.

{
  "name": "dylansg.com",
  "description": "Read-only, the same facts the site shows. Every record has `page`, the address of the page it came from.",
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/dylan",
      "description": "Who this is: role, employer, the one-sentence summary in either register, location, links.",
      "params": [
        {
          "name": "view",
          "description": "Which register the summary is written in. The site has two; the pages show both.",
          "one_of": [
            "plain",
            "engineer"
          ]
        },
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/lib/site.ts",
      "page": "https://dylansg.com/"
    },
    {
      "method": "GET",
      "path": "/api/work",
      "description": "What I built at my job: the ERP and the AI coding setup around it. Their parts are in each one's record.",
      "params": [
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/content/projects/*",
      "page": "https://dylansg.com/work"
    },
    {
      "method": "GET",
      "path": "/api/work/{id}",
      "description": "One piece of work in full: the contract (problem, what was unique, what I learned), the numbers, the parts.",
      "params": [
        {
          "name": "id",
          "description": "An id from GET /api/work, or a part of one like internal-erp/repricing.",
          "one_of": []
        },
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/content/projects/{id}",
      "page": "https://dylansg.com/work/internal-erp"
    },
    {
      "method": "GET",
      "path": "/api/projects",
      "description": "Everything else I built: tools, games and a course project, newest and most important first.",
      "params": [
        {
          "name": "category",
          "description": "Filter to one shelf: tool, game or course. What the thing is, not what it was built with.",
          "one_of": [
            "tool",
            "game",
            "course"
          ]
        },
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/content/projects/*",
      "page": "https://dylansg.com/projects"
    },
    {
      "method": "GET",
      "path": "/api/projects/{id}",
      "description": "One project in full: the contract (problem, what was unique, what I learned), the numbers.",
      "params": [
        {
          "name": "id",
          "description": "An id from GET /api/projects.",
          "one_of": []
        },
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/content/projects/{id}",
      "page": "https://dylansg.com/projects/receipt-splitter"
    },
    {
      "method": "GET",
      "path": "/api/experience",
      "description": "The path here — the stops, the jobs, education and certifications.",
      "params": [
        {
          "name": "since",
          "description": "Only jobs that started in this year or later.",
          "one_of": [
            "2021",
            "2022",
            "2025"
          ]
        },
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/lib/site.ts",
      "page": "https://dylansg.com/about"
    },
    {
      "method": "GET",
      "path": "/api/resume",
      "description": "The one-page résumé: summary, experience with bullets, projects, skills, education. The same facts as the PDF.",
      "params": [
        {
          "name": "format",
          "description": "json returns the record; html and pdf return the record with `page` pointing at that version.",
          "one_of": [
            "json",
            "html",
            "pdf"
          ]
        },
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/lib/site.ts",
      "page": "https://dylansg.com/resume"
    },
    {
      "method": "GET",
      "path": "/api/away-from-work",
      "description": "What I do when I'm not at a keyboard, and the first thing I ever shipped. It still runs.",
      "params": [
        {
          "name": "playable",
          "description": "When true, `page` is the playable game instead of its write-up."
        },
        {
          "name": "fields",
          "description": "Comma-separated keys to return instead of the whole record. `page` always comes back."
        }
      ],
      "source": "src/lib/site.ts · src/content/projects/galaxy-defense",
      "page": "https://dylansg.com/#away"
    },
    {
      "method": "POST",
      "path": "/api/contact",
      "description": "Send a message. Until mail delivery is configured the route answers 503 with a mailto link, and the console opens it.",
      "params": [
        {
          "name": "from",
          "description": "Your email, so I can reply."
        },
        {
          "name": "message",
          "description": "The message. Ten characters or more."
        }
      ],
      "source": "src/pages/api/contact.ts",
      "page": "https://dylansg.com/contact"
    },
    {
      "method": "GET",
      "path": "/api",
      "description": "This list: every endpoint, what it takes, where the answer comes from and which page it's on.",
      "params": [],
      "source": "src/lib/endpoints.ts",
      "page": "https://dylansg.com/reference"
    }
  ],
  "fields": "Add ?fields=a,b to any GET to get only those keys; `page` always comes back.",
  "page": "https://dylansg.com/reference"
}