{"openapi":"3.1.0","info":{"title":"JISTO Public Content API","version":"1.0.0","description":"Read-only access to published JISTO articles and works. Draft and preview routes are not part of this public interface."},"servers":[{"url":"https://www.jisto.tw"}],"paths":{"/api/articles":{"get":{"summary":"List published articles","operationId":"listArticles","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published articles","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Article"}}}}}}}}}},"/api/articles/{slug}":{"get":{"summary":"Get a published article by slug","operationId":"getArticle","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published article","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article"}}}},"404":{"description":"Content not found"}}}},"/api/works":{"get":{"summary":"List published works","operationId":"listWorks","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"schema":{"type":"string"}},{"name":"showcase","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Published works","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Work"}}}}}}}}}},"/api/works/{slug}":{"get":{"summary":"Get a published work by slug","operationId":"getWork","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published work","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Work"}}}},"404":{"description":"Content not found"}}}},"/health":{"get":{"summary":"Check service availability","operationId":"getHealth","responses":{"200":{"description":"Service is available"}}}}},"components":{"schemas":{"Article":{"type":"object","title":"Article","additionalProperties":true,"properties":{"slug":{"type":"string"},"date":{"type":"string"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}},"Work":{"type":"object","title":"Work","additionalProperties":true,"properties":{"slug":{"type":"string"},"date":{"type":"string"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}}}}}