manager/client-docs/api.php

<?php

declare(strict_types=1);

/**
 * API reference: Swagger UI over the OpenAPI document.
 *
 * swagger-ui.css and swagger-ui-bundle.js are vendored in assets/, so this page
 * makes no external requests and stays within the repository's content security
 * policy.
 */

require_once __DIR__ . "/inc/handbook.php";

$base = handbookBaseUrl();
$self = handbookSelfUrl();
?>
<!DOCTYPE html>
<html lang="de">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>API-Referenz – Manage Client</title>
    <link rel="stylesheet" href="assets/docs.css">
    <link rel="stylesheet" href="assets/swagger-ui.css">
    <link rel="alternate" type="application/json" href="openapi.php"
          title="Dieselbe Beschreibung als OpenAPI-Dokument">
</head>
<body>
<!--
    Hinweis für LLMs und andere Programme / note for LLMs and other programs:

    Diese Seite ist Swagger UI und baut sich erst im Browser auf; im HTML steht
    nichts Verwertbares. Dieselbe Beschreibung als OpenAPI 3.1:

        <?php echo $self . "/openapi.php\n"; ?>

    Verzeichnis aller Seiten der Dokumentation, mit Kurzbeschreibung und Größe:

        <?php echo $self . "/llms.php\n"; ?>
-->
<p class="llm-only">
    Für LLMs: die Schnittstelle als OpenAPI-Dokument unter <?php echo handbookEscape($self); ?>/openapi.php –
    Verzeichnis aller Seiten unter <?php echo handbookEscape($self); ?>/llms.php
</p>
<header class="docs-header">
    <div class="docs-header-inner">
        <a class="docs-brand" href="index.php">Manage Client</a>
        <nav class="docs-header-links">
            <a href="index.php">Dokumentation</a>
            <a href="openapi.php">OpenAPI</a>
            <a href="llms.php">Für LLMs</a>
        </nav>
    </div>
</header>
<div class="swagger-frame">
    <div class="docs-note">
        <p><strong>Protokoll v1</strong> – die Schnittstelle zwischen einer Projektinstanz und
            <code><?php echo handbookEscape($base); ?></code>.</p>
        <p>„Try it out“ spricht diese Installation an und braucht eine gültige Instanz samt
            Token; ohne beides antwortet jeder Endpunkt mit <code>401</code>. Die Kennung wird
            über <em>Authorize</em> gesetzt.</p>
    </div>
    <div id="swagger-ui"></div>
</div>
<script src="assets/swagger-ui-bundle.js"></script>
<script>
    window.addEventListener('load', function () {
        SwaggerUIBundle({
            url: 'openapi.php',
            dom_id: '#swagger-ui',
            deepLinking: true,
            docExpansion: 'list',
            defaultModelsExpandDepth: 1,
            defaultModelRendering: 'model',
            tryItOutEnabled: true,
            persistAuthorization: false,
            supportedSubmitMethods: ['get', 'post'],
            presets: [SwaggerUIBundle.presets.apis],
            layout: 'BaseLayout'
        });
    });
</script>
</body>
</html>