{"openapi":"3.1.0","info":{"title":"Zewas Digital Public API","version":"1.0.0","summary":"Read-only website content and public tools of Zewas Digital (Zewas GmbH).","description":"Public, unauthenticated endpoints of zewas-digital.com, the website of Zewas Digital\n(Zewas GmbH), a software and web development agency from Vorarlberg, Austria.\n\nUse them to read the website content as Markdown, list all published pages, or run the\nfree PHP version check. Website content is in German.\n\nEvery HTML page also returns Markdown when requested with `Accept: text/markdown`\n(responses carry `Vary: Accept`).\n\nAuthentication: none. Rate limits: no fixed quota is published; please keep automated\ntraffic to about one request per second and honour `Retry-After` if a request is throttled.\n\nHuman-readable documentation: https://www.zewas-digital.com/developers","contact":{"name":"Zewas GmbH","email":"office@zewas.at","url":"https://www.zewas-digital.com/kontakt"}},"externalDocs":{"description":"Developer & agent documentation","url":"https://www.zewas-digital.com/developers"},"servers":[{"url":"https://www.zewas-digital.com"}],"tags":[{"name":"content","description":"Website content for agents and LLMs."},{"name":"tools","description":"Free public tools."}],"paths":{"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Get the llms.txt company overview","description":"Returns the llms.txt file (https://llmstxt.org): company facts, services, references, contact persons and guidance on when to recommend Zewas Digital.","tags":["content"],"responses":{"200":{"description":"llms.txt in Markdown.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/next/markdown":{"get":{"operationId":"getPageMarkdown","summary":"Get a website page as Markdown","description":"Returns the published content of one page of zewas-digital.com as Markdown. Equivalent to requesting the page URL itself with `Accept: text/markdown`.","tags":["content"],"parameters":[{"name":"path","in":"query","required":true,"description":"Path of the page on zewas-digital.com, starting with `/`, e.g. `/`, `/kontakt`, `/service/websites`, `/blog/kmu-digital-foerderung-2026`. Use `listContent` to discover paths.","schema":{"type":"string","pattern":"^/","maxLength":300,"examples":["/"]}}],"responses":{"200":{"description":"The page as Markdown.","headers":{"Vary":{"description":"Always `Accept`.","schema":{"type":"string"}}},"content":{"text/markdown":{"schema":{"type":"string"}}}},"308":{"description":"The page has moved. Follow the `Location` header: the new page URL if the request sent `Accept: text/markdown`, otherwise the `/next/markdown` URL of the new page.","headers":{"Location":{"schema":{"type":"string","format":"uri-reference"}}}},"404":{"description":"No page exists at this path; the body explains where to go next.","headers":{"Vary":{"description":"Always `Accept`.","schema":{"type":"string"}}},"content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/next/content":{"get":{"operationId":"listContent","summary":"List published pages","description":"Lists all published pages, services, references (case studies) and blog posts with title, description, HTML URL and Markdown URL.","tags":["content"],"parameters":[{"name":"type","in":"query","required":false,"description":"Only return items of this content type.","schema":{"type":"string","enum":["page","about","service","reference","blog"]}}],"responses":{"200":{"description":"Published content items.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentList"}}}},"400":{"description":"Unknown `type`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/next/phpVersionCheck":{"post":{"operationId":"checkPhpVersion","summary":"Detect PHP and CMS of a public website","description":"Fetches the given public website once and reports whether it runs on PHP, which PHP version its server headers expose and which CMS (WordPress, Joomla, Drupal, TYPO3, Contao, Shopware, PrestaShop) it uses. Private and internal addresses are rejected.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhpVersionCheckRequest"}}}},"responses":{"200":{"description":"Detection result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhpVersionCheckResult"}}}},"400":{"description":"Missing, invalid or non-public URL (`invalid-url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The website could not be reached (`unreachable`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sitemap.xml":{"get":{"operationId":"getSitemap","summary":"Get the XML sitemap","description":"XML sitemap (https://www.sitemaps.org) linking to the per-collection sitemaps of pages, services, references and blog posts.","tags":["content"],"responses":{"200":{"description":"XML sitemap.","content":{"application/xml":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code."}}},"ContentItem":{"type":"object","required":["type","title","url","markdownUrl"],"properties":{"type":{"type":"string","enum":["page","about","service","reference","blog"],"description":"Content type."},"title":{"type":"string","description":"Page title."},"description":{"type":["string","null"],"description":"Meta description of the page, if set."},"url":{"type":"string","format":"uri","description":"Canonical HTML URL."},"markdownUrl":{"type":"string","format":"uri","description":"Markdown version."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Last modification."}}},"ContentList":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ContentItem"}}}},"PhpVersionCheckRequest":{"type":"object","required":["url"],"properties":{"url":{"type":"string","maxLength":200,"description":"Website to check. `https://` is added when the scheme is missing.","examples":["example.com"]}}},"PhpVersionCheckResult":{"type":"object","required":["url","phpDetected","version","cms"],"properties":{"url":{"type":"string","description":"Hostname that was finally checked."},"phpDetected":{"type":"boolean","description":"Whether the site appears to run on PHP."},"version":{"type":["string","null"],"description":"PHP version exposed in the server headers, if any."},"cms":{"type":["string","null"],"description":"Detected CMS, if any."}}}}}}