REST-API-Referenz

Die Page Lemon REST API findest du unter https://api.pagelemon.com/v1. Code-Agents mit Shell nutzen sie, um einen Ordner mit einem Befehl zu veröffentlichen; KI-Agents sollten mit der Veröffentlichungsanleitung für KIs (Markdown) beginnen.

Zuletzt aktualisiert 13. Oktober 2026 · Als Markdown ansehen

Schnellstart

Veröffentliche einen Ordner ohne Konto (er bleibt 72 Stunden online, wenn du ihn nicht behältst):

tar -czf - -C dist . | curl -sS --data-binary @- https://api.pagelemon.com/v1/deploy

Mit einem API-Token landet die Website direkt in deinem Konto:

tar -czf - -C dist . | curl -sS -H "Authorization: Bearer $PAGELEMON_TOKEN" --data-binary @- https://api.pagelemon.com/v1/deploy

Hosts

Authentifizierung

Sende Zugangsdaten als Authorization: Bearer <token>.

Wir speichern nur Hashes von Tokens, ein verlorenes Token kann also nicht erneut angezeigt werden. Erstelle stattdessen ein neues.

Fehler

{ "error": { "code": "conflict", "message": "…" }, "agent_message": "…" }

agent_message ist vorhanden, wenn die KI dem Nutzer etwas mitteilen soll. Gib es in der Sprache des Nutzers weiter, mit allen Links, Codes, Zahlen, Daten und Domains exakt so, wie sie sind. Zeiten sind in UTC, und *_at-Felder enthalten sie im ISO-Format.

Veröffentlichen

POST /v1/deploy: ein Archiv

Der Request-Body ist das Archiv: .tar.gz, .tgz, .tar oder .zip. Der Server erkennt das Format an den Bytes, Content-Type ist also optional.

tar -czf - -C <dir> . | curl -sS --data-binary @- https://api.pagelemon.com/v1/deploy

Jede Veröffentlichung ersetzt die ganze Website: Dateien, die du weglässt, werden von der Live-Website entfernt. Liegen alle Dateien in einem einzigen obersten Ordner (dist/index.html, …), wird dieser Ordner entfernt.

Antwort 201:

{
  "site": { "name": "brave-otter-4821", "url": "https://brave-otter-4821.pagelemon.dev", "claimed": false, "expires_at": "2026-10-14T14:40:00Z" },
  "revision": { "id": "rev_…", "number": 1, "files": 12, "bytes": 48213 },
  "site_token": "st_…",
  "claim_url": "https://app.pagelemon.com/claim/ct_…",
  "skipped": [".env", "node_modules/…"],
  "agent_message": "Your site is live at …"
}

site_token und claim_url erscheinen nur beim anonymen Erstellen.

POST /v1/deploy mit JSON: Inline-Dateien

Für MCP-Clients und kleine Websites: Sende Content-Type: application/json an denselben Endpunkt.

{ "site": "brave-otter-4821", "base_revision": "rev_…", "files": [ { "path": "index.html", "content": "<h1>Hi</h1>", "encoding": "utf8" } ] }

encoding ist utf8 oder base64. Lass site und base_revision weg, um eine neue Website zu erstellen. Die Antwort ist dieselbe wie oben.

Patch: Füge "patch": true hinzu, um nur die geänderten files plus "deleted": ["old.html"] auf Basis von base_revision zu senden; alles andere bleibt erhalten. Gleiche Limits und Prüfungen; ein veraltetes base_revision ergibt 409 conflict.

Upload-Regeln

Pro Website meint die ganze Live-Website nach einem Deploy; ein Patch zählt die gesamte resultierende Website. In bezahlten Tarifen kann eine Website den gesamten Speicher des Tarifs nutzen, aber eine Anfrage trägt höchstens 90 MB (40 MB über MCP): Sende eine größere Website als ersten Deploy und den Rest als Patch-Deploys. Über dem Limit: 413 too_large mit einem agent_message zur Anzeige.

• Abgelehnt: Symlinks, Hardlinks, Geräte, absolute Pfade, .. und doppelte Pfade, die sich nur in der Groß-/Kleinschreibung unterscheiden.
• Übersprungen und in skipped aufgeführt: .git/, node_modules/, .env*, *.map, *.pem, *.key; Dotfiles außer .well-known/; .DS_Store, Thumbs.db.
• Leak-Schutz: Textdateien werden auf bekannte Arten geheimer und privater Schlüssel geprüft. Ein Treffer liefert 422 blocked_secret mit {file, line, kind}. Der Schlüssel selbst wird nie zurückgegeben.
• Erforderlich: index.html im Stammverzeichnis.
• Nur anonym: Ausführbare Dateien und Installer werden blockiert, und jedes Netzwerk bekommt nur eine kleine Zahl anonymer Websites und Veröffentlichungen. Für mehr übernimm die Website oder melde dich an.

Websites

Rollen: Betrachter können die Website und ihren Verlauf lesen. Bearbeiter können zusätzlich veröffentlichen und zurücksetzen. Inhaber können zusätzlich einladen, umbenennen und löschen.

Konto

Websites übernehmen, Einladungen annehmen, Tokens und Abrechnung laufen über app.pagelemon.com.

Auslieferung auf pagelemon.dev

• / liefert index.html aus. /about liefert about.html oder about/index.html aus.
• Fehlende Dateien bekommen die 404.html der Website, falls vorhanden, sonst unsere.
• Fallback für Single-Page-Apps: Hat die Website keine 404.html und der Pfad keine Dateiendung, wird index.html ausgeliefert.
• Header: X-Content-Type-Options: nosniff, Referrer-Policy: strict-origin-when-cross-origin, Cache-Control: public, max-age=60 für HTML und max-age=300 für andere Dateien. Inhaltstypen stammen aus einer Allowlist; unbekannte Typen werden als application/octet-stream ausgeliefert.
• Anonyme und kostenlose Websites bekommen vor </body> ein kleines "Live auf Page Lemon"-Badge. Es besteht aus einfachem HTML und CSS, ohne Skript, und enthält einen Link zum Melden der Website.
• Abgelaufene oder gelöschte Websites liefern 410. Wegen Missbrauchs entfernte Websites liefern 451.

.pagelemon.json

Nach dem Veröffentlichen schreiben Agenten diese Datei in den Projektordner und fügen sie zu .gitignore hinzu, damit die nächste Sitzung dieselbe Website aktualisieren kann:

{ "site": "brave-otter-4821", "url": "https://brave-otter-4821.pagelemon.dev", "revision": "rev_…", "site_token": "st_…" }