{"openapi":"3.1.0","info":{"title":"PlainNerd public API","version":"1.0.0","description":"English technology publishing. Public writes enter moderation. No publishing or MCP endpoint is exposed."},"servers":[{"url":"https://plainnerd.com"}],"paths":{"/api/articles":{"get":{"summary":"List public articles; editorial previews are explicitly marked","responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/api/articles/{slug}":{"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Read one public article including TipTap JSON","responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/api/comments":{"get":{"summary":"Read approved comments for the slug query parameter","responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}},"post":{"summary":"Submit a comment for moderation","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":200,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"author":{"type":"string","minLength":2,"maxLength":100},"content":{"type":"object","properties":{"type":{"type":"string","const":"doc"},"content":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"paragraph"},"content":{"maxItems":10,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","minLength":1,"maxLength":500},"marks":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"bold"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"italic"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"code"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"link"},"attrs":{"type":"object","properties":{"href":{"type":"string","maxLength":2048,"format":"uri","pattern":"^https?:\\/\\/[^\\s]+$"},"target":{"anyOf":[{"type":"string","enum":["_blank","_self"]},{"type":"null"}]},"rel":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"class":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["href"],"additionalProperties":false}},"required":["type","attrs"],"additionalProperties":false}]}}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"hardBreak"}},"required":["type"],"additionalProperties":false}]}}},"required":["type"],"additionalProperties":false}}},"required":["type","content"],"additionalProperties":false,"description":"At least 3 non-whitespace text characters; invisible formatting characters do not count."}},"required":["slug","author","content"],"additionalProperties":false}}}},"responses":{"202":{"description":"Accepted; never publishes automatically"},"400":{"description":"Invalid JSON"},"413":{"description":"Body exceeds 64 KiB"},"422":{"description":"Schema validation failed"},"429":{"description":"Rate limited"},"503":{"description":"Storage unavailable"}}},"parameters":[{"name":"slug","in":"query","schema":{"type":"string"}}]},"/api/submissions":{"post":{"summary":"Submit an article proposal for moderation","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":5,"maxLength":160},"description":{"type":"string","minLength":10,"maxLength":320},"author":{"type":"string","minLength":2,"maxLength":100},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"content":{"type":"object","properties":{"type":{"type":"string","const":"doc"},"content":{"minItems":1,"maxItems":250,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"paragraph"},"content":{"maxItems":100,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","minLength":1,"maxLength":20000},"marks":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"bold"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"italic"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"code"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"link"},"attrs":{"type":"object","properties":{"href":{"type":"string","maxLength":2048,"format":"uri","pattern":"^https?:\\/\\/[^\\s]+$"},"target":{"anyOf":[{"type":"string","enum":["_blank","_self"]},{"type":"null"}]},"rel":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"class":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["href"],"additionalProperties":false}},"required":["type","attrs"],"additionalProperties":false}]}}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"hardBreak"}},"required":["type"],"additionalProperties":false}]}}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"heading"},"attrs":{"type":"object","properties":{"level":{"anyOf":[{"type":"number","const":2},{"type":"number","const":3}]}},"required":["level"],"additionalProperties":false},"content":{"maxItems":30,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","minLength":1,"maxLength":20000},"marks":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"bold"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"italic"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"code"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"link"},"attrs":{"type":"object","properties":{"href":{"type":"string","maxLength":2048,"format":"uri","pattern":"^https?:\\/\\/[^\\s]+$"},"target":{"anyOf":[{"type":"string","enum":["_blank","_self"]},{"type":"null"}]},"rel":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"class":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["href"],"additionalProperties":false}},"required":["type","attrs"],"additionalProperties":false}]}}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"hardBreak"}},"required":["type"],"additionalProperties":false}]}}},"required":["type","attrs"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"bulletList"},"content":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"listItem"},"content":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"paragraph"},"content":{"maxItems":100,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","minLength":1,"maxLength":20000},"marks":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"bold"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"italic"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"code"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"link"},"attrs":{"type":"object","properties":{"href":{"type":"string","maxLength":2048,"format":"uri","pattern":"^https?:\\/\\/[^\\s]+$"},"target":{"anyOf":[{"type":"string","enum":["_blank","_self"]},{"type":"null"}]},"rel":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"class":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["href"],"additionalProperties":false}},"required":["type","attrs"],"additionalProperties":false}]}}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"hardBreak"}},"required":["type"],"additionalProperties":false}]}}},"required":["type"],"additionalProperties":false}}},"required":["type","content"],"additionalProperties":false}}},"required":["type","content"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"orderedList"},"attrs":{"type":"object","properties":{"start":{"type":"integer","minimum":1,"maximum":10000},"type":{"anyOf":[{"type":"string","enum":["1","a","A","i","I"]},{"type":"null"}]}},"required":["start"],"additionalProperties":false},"content":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"listItem"},"content":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"paragraph"},"content":{"maxItems":100,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","minLength":1,"maxLength":20000},"marks":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"bold"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"italic"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"code"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"link"},"attrs":{"type":"object","properties":{"href":{"type":"string","maxLength":2048,"format":"uri","pattern":"^https?:\\/\\/[^\\s]+$"},"target":{"anyOf":[{"type":"string","enum":["_blank","_self"]},{"type":"null"}]},"rel":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"class":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["href"],"additionalProperties":false}},"required":["type","attrs"],"additionalProperties":false}]}}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"hardBreak"}},"required":["type"],"additionalProperties":false}]}}},"required":["type"],"additionalProperties":false}}},"required":["type","content"],"additionalProperties":false}}},"required":["type","content"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"blockquote"},"content":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"paragraph"},"content":{"maxItems":100,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","minLength":1,"maxLength":20000},"marks":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"bold"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"italic"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"code"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"link"},"attrs":{"type":"object","properties":{"href":{"type":"string","maxLength":2048,"format":"uri","pattern":"^https?:\\/\\/[^\\s]+$"},"target":{"anyOf":[{"type":"string","enum":["_blank","_self"]},{"type":"null"}]},"rel":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"class":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"required":["href"],"additionalProperties":false}},"required":["type","attrs"],"additionalProperties":false}]}}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"hardBreak"}},"required":["type"],"additionalProperties":false}]}}},"required":["type"],"additionalProperties":false}}},"required":["type","content"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"codeBlock"},"attrs":{"type":"object","properties":{"language":{"anyOf":[{"type":"string","pattern":"^[a-zA-Z0-9_+-]{0,30}$"},{"type":"null"}]}},"additionalProperties":false},"content":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string","minLength":1,"maxLength":20000}},"required":["type","text"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"horizontalRule"}},"required":["type"],"additionalProperties":false}]}}},"required":["type","content"],"additionalProperties":false,"description":"At least 30 non-whitespace text characters; invisible formatting characters do not count."}},"required":["title","description","author","email","content"],"additionalProperties":false}}}},"responses":{"202":{"description":"Accepted; never publishes automatically"},"400":{"description":"Invalid JSON"},"413":{"description":"Body exceeds 64 KiB"},"422":{"description":"Schema validation failed"},"429":{"description":"Rate limited"},"503":{"description":"Storage unavailable"}}}},"/api/newsletter":{"post":{"summary":"Record an email address with explicit consent","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"consent":{"type":"boolean","const":true}},"required":["email","consent"],"additionalProperties":false}}}},"responses":{"202":{"description":"Accepted; never publishes automatically"},"400":{"description":"Invalid JSON"},"413":{"description":"Body exceeds 64 KiB"},"422":{"description":"Schema validation failed"},"429":{"description":"Rate limited"},"503":{"description":"Storage unavailable"}}}},"/api/schema/article":{"get":{"summary":"Versioned article JSON Schema","responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/api/schema/comment":{"get":{"summary":"Versioned comment document JSON Schema","responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/content/{slug}.md":{"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Article Markdown with JSON-compatible YAML metadata","responses":{"200":{"description":"Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}}}}}}}