# 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:

```http
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 |