50_API.md 1000 B
Teil 2 – HTTP-API
Die Schnittstelle zwischen Client und Manage-Server, Protokoll v1. Wer den
mitgelieferten Client übernimmt, braucht diesen Teil nicht – er ist für eigene Clients,
für Debugging und für die Fehlersuche mit curl gedacht. Die ausführliche Beschreibung
mit Beispielaufrufen steht im Kapitel Protokoll in Teil 1.
Basis-URL dieser Installation: {{BASE_URL}}/api/v1
Zum Ausprobieren im Browser, mit Swagger UI: <{{SELF_URL}}/api.php>. Das Dokument allein, für Codegeneratoren: <{{SELF_URL}}/openapi.php>.
Jede Anfrage trägt zwei Header:
X-Manage-Instance: meinprojekt-prod
X-Manage-Token: e4032c4dc51e9100…
Vier Endpunkte:
| Methode | Pfad | Zweck |
|---|---|---|
GET |
/manifest.php |
Welches Release soll installiert werden |
GET |
/package.php?version=vX.Y.Z |
Das Release-ZIP |
POST |
/backup.php |
Backup-Archiv hochladen (multipart/form-data) |
POST |
/heartbeat.php |
Status melden, Update-Information erhalten |