Public Pages
Eine HTML-Seite anlegen, veröffentlichen, teilen und später aktualisieren.
Eine Public Page ist eine veröffentlichte Seite mit eigener Versionshistorie. Ein Skript legt sie an, veröffentlicht sie und teilt einen Link. Später ersetzt es den Entwurf und veröffentlicht erneut; der geteilte Link zeigt dann automatisch die neue Version.
Richtige Basis-URL
Skripte mit API-Schlüssel sprechen https://api.adlass.io/v1 (Entwicklung: https://dev.adlass.io/v1). Die Routen …/api/v1/operations/<key>/invoke/ gehören zur Webapp und zum MCP-Server und nehmen keine API-Schlüssel an; sie antworten mit route_not_found.
Seite anlegen
Der Schlüssel braucht pages:write. html ist ein vollständiges HTML-Dokument (max. 5 MiB); settings.locale legt die Sprache der Seite fest.
curl https://api.adlass.io/v1/pages \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d @- <<'JSON'
{"space_id":"SPACE_UUID","kind":"html","name":"Quartalsbericht",
"html":"<!doctype html><html><body><h1>Q3</h1></body></html>",
"settings":{"locale":"de","show_brand":false}}
JSONDie Antwort ist der Entwurf (status: DRAFT). Merke dir id.
Veröffentlichen und Link erstellen
POST /pages/{page_id}/publish friert den Entwurf als Version 1 ein. Danach erstellt POST /pages/{page_id}/links einen Share-Link; die Antwort enthält die öffentliche url einmalig.
curl -X POST https://api.adlass.io/v1/pages/PAGE_UUID/publish \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"
curl https://api.adlass.io/v1/pages/PAGE_UUID/links \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"label":"Vorstand","submission_mode":"NONE","locale":"de"}'Aktualisieren und erneut veröffentlichen
PUT /pages/{page_id}/draft mit neuem html ersetzt den Entwurf. Ein erneutes publish erzeugt Version 2. Links folgen standardmäßig der neuesten Version: der bereits verschickte Link zeigt ohne weiteren Aufruf den neuen Inhalt. Die Publish-Antwort listet die umgezogenen Links in retargeted_link_ids.
curl -X PUT https://api.adlass.io/v1/pages/PAGE_UUID/draft \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"html":"<!doctype html><html><body><h1>Q3, korrigiert</h1></body></html>"}'
curl -X POST https://api.adlass.io/v1/pages/PAGE_UUID/publish \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"Soll ein Link auf einer bestimmten Version bleiben, erstelle ihn mit "pinned": true oder setze ihn mit POST /page-links/{link_id}/retarget auf eine Version; das fixiert ihn. PATCH /page-links/{link_id} mit "pinned": false lässt ihn wieder folgen.
Weiterlesen
Idempotenz für sichere Wiederholungen, die Referenz für alle Felder von Seiten und Links.