{"openapi":"3.1.0","info":{"title":"LitPage Content Delivery API","version":"1.0.0"},"servers":[{"url":"/api/delivery/v1"}],"security":[],"paths":{"/pages/by-path":{"get":{"operationId":"getPublishedPageByPath","summary":"Read a published page at a website path","description":"Reads published section-based pages. Collection entrypoints return 422 and continue to use the existing content-list interface. Language is separate from the unprefixed page path. A moved page returns a redirect resource; the website renderer emits the actual 301.","parameters":[{"name":"domain","in":"query","required":true,"description":"Registered hostname without scheme, port or path.","schema":{"type":"string","maxLength":253}},{"name":"path","in":"query","required":true,"description":"Unprefixed page path, starting with /. No query, fragment or dot segments.","schema":{"$ref":"#/components/schemas/Path"}},{"name":"language","in":"query","required":false,"description":"LitPage language code (case-insensitive). Omit to select the site default.","schema":{"$ref":"#/components/schemas/Language"}},{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Published page or redirect resource.","headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryResource"}}}},"304":{"description":"Current published representation matches the validator. No body."},"400":{"description":"Request failed; body contains a stable code. Never cache this response.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Request failed; body contains a stable code. Never cache this response.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Request failed; body contains a stable code. Never cache this response.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Request failed; body contains a stable code. Never cache this response.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Request failed; body contains a stable code. Never cache this response.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Request failed; body contains a stable code. Never cache this response.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Request failed; body contains a stable code. Never cache this response.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"schemas":{"Text":{"type":"string","minLength":1},"Language":{"type":"string","enum":["EN","ZH_CN","ZH_TW","ES","HI","FR","DE","RU","PT","AR","JA","KO","IT","TR","PL","NL","ID","TH","VI","SV","RO"]},"Path":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^/(?!/)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^?#\\\\\\s\\u0000-\\u001f\\u007f]*$"},"Origin":{"type":"string","pattern":"^https://[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$"},"Section":{"type":"object","required":["type"],"properties":{"type":{"$ref":"#/components/schemas/Text"},"id":{"type":"string"}}},"PageResource":{"type":"object","required":["schemaVersion","kind","site","page","content","layout","localization","seo"],"properties":{"schemaVersion":{"const":1},"kind":{"const":"page"},"site":{"type":"object","required":["key","domain","canonicalOrigin","origins"],"properties":{"key":{"$ref":"#/components/schemas/Text"},"domain":{"$ref":"#/components/schemas/Text"},"canonicalOrigin":{"$ref":"#/components/schemas/Origin"},"origins":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/components/schemas/Origin"}}}},"page":{"type":"object","required":["id","revisionId","nanoid","path","language","title","description"],"properties":{"id":{"$ref":"#/components/schemas/Text"},"revisionId":{"$ref":"#/components/schemas/Text"},"nanoid":{"$ref":"#/components/schemas/Text"},"path":{"$ref":"#/components/schemas/Path"},"language":{"$ref":"#/components/schemas/Language"},"title":{"type":"string"},"description":{"type":"string"}}},"content":{"type":"object","required":["sections"],"properties":{"sections":{"type":"array","items":{"$ref":"#/components/schemas/Section"}}}},"layout":{"type":"object","required":["header","footer","theme","settings"],"properties":{"header":{"type":["object","null"]},"footer":{"type":["object","null"]},"theme":{"$ref":"#/components/schemas/Text"},"settings":{"type":"object","required":["pageWidth","colorMode","theme"],"properties":{"pageWidth":{"$ref":"#/components/schemas/Text"},"colorMode":{"$ref":"#/components/schemas/Text"},"theme":{"$ref":"#/components/schemas/Text"}}}}},"localization":{"type":"object","required":["currentLanguage","defaultLanguage","supportedLanguages","translatedLanguages","languageNames","languageUrls","languageVersions"],"properties":{"currentLanguage":{"$ref":"#/components/schemas/Language"},"defaultLanguage":{"$ref":"#/components/schemas/Language"},"supportedLanguages":{"type":"array","items":{"$ref":"#/components/schemas/Language"}},"translatedLanguages":{"type":"array","items":{"$ref":"#/components/schemas/Language"}},"languageNames":{"type":"object","additionalProperties":{"type":"string"}},"languageUrls":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Path"}},"languageVersions":{"type":"object","additionalProperties":{"type":"object","required":["id","nanoid","status"],"properties":{"id":{"$ref":"#/components/schemas/Text"},"nanoid":{"$ref":"#/components/schemas/Text"},"status":{"const":"PUBLISHED"}}}}}},"seo":{"type":"object","required":["title","description","canonicalUrl"],"properties":{"title":{"type":"string"},"description":{"type":"string"},"canonicalUrl":{"type":"string","format":"uri","pattern":"^https?://"}}}}},"RedirectResource":{"type":"object","required":["schemaVersion","kind","redirect"],"properties":{"schemaVersion":{"const":1},"kind":{"const":"redirect"},"redirect":{"type":"object","required":["status","location"],"properties":{"status":{"const":301},"location":{"type":"string","pattern":"^/[a-z0-9]+(?:[-_/][a-z0-9]+)*$"}}}}},"DeliveryResource":{"oneOf":[{"$ref":"#/components/schemas/PageResource"},{"$ref":"#/components/schemas/RedirectResource"}]},"Problem":{"type":"object","required":["type","title","status","detail","code","requestId"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string"}}}}}}