API-Dokumentation

Zuletzt aktualisiert: 2026-08-29

Mit der hdply-API verwalten Skripte und KI-Agenten Ihre Websites programmatisch: Projekte auflisten, HTML lesen, Updates veröffentlichen und neue Websites erstellen. Es ist eine kleine, vorhersehbare REST-API — wer curl bedienen kann, kann hdply bedienen.

Authentifizierung

Erstellen Sie Ihren persönlichen API-Schlüssel im Konsolen-Dashboard (Karte „API-Schlüssel“). Senden Sie ihn bei jeder Anfrage als Bearer-Token:

Authorization: Bearer hdply_sk_…

Der Schlüssel wird nur einmal bei der Erstellung angezeigt; Neuerstellen ersetzt ihn, Löschen widerruft ihn sofort. Halten Sie ihn geheim — er gewährt Zugriff auf alle Ihre Projekte.

Basis-URL

https://api.app.hdply.com

Endpunkte

GET /v1/projects — listet Ihre Projekte auf.
POST /v1/projects — erstellt ein Projekt. JSON-Body: {"name": "optional", "html": "optional"}. Mit html ist die Website sofort live; ohne Namen wird der <title> des HTML verwendet. Die Subdomain vergibt der Server zufällig.
GET /v1/projects/{id} — ein Projekt. {id} akzeptiert die numerische id oder die Subdomain (z. B. k3v9x2m7q1).
GET /v1/projects/{id}/html — das aktuell veröffentlichte HTML.
PUT /v1/projects/{id}/html — veröffentlicht neues HTML (roher text/html-Body, live sobald die Antwort zurückkommt).
GET /v1/projects/{id}/deployments — Deploy-Verlauf (API-Deploys tragen "source": "api").
PATCH /v1/projects/{id}/settings — schaltet die Indexierung durch Suchmaschinen ein oder aus. JSON-Body: {"indexable": true}. Bis dahin werden Seiten nicht indexiert.

Es gibt kein DELETE. Das Entfernen einer Website ist bewusst nur im Web möglich, damit ein automatisierter Agent Ihre Arbeit niemals zerstören kann. Jeder API-Deploy ist versioniert — jede frühere Version lässt sich über die Konsole wiederherstellen.

Schnellstart

export HDPLY_KEY=hdply_sk_…

# create a site and go live in one call
curl -X POST https://api.app.hdply.com/v1/projects \
  -H "Authorization: Bearer $HDPLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<!doctype html><title>Hello</title><h1>Hi!</h1>"}'
# → {"project": {"subroute": "k3v9x2m7q1", "url": "https://k3v9x2m7q1.hdply.com", …}}

# read the live HTML
curl https://api.app.hdply.com/v1/projects/k3v9x2m7q1/html \
  -H "Authorization: Bearer $HDPLY_KEY"

# publish an update
curl -X PUT https://api.app.hdply.com/v1/projects/k3v9x2m7q1/html \
  -H "Authorization: Bearer $HDPLY_KEY" \
  -H "Content-Type: text/html" \
  --data-binary @index.html

Limits und Fehler

HTML ist auf 1 MB pro Website begrenzt (eine einzelne, in sich geschlossene Datei funktioniert am besten).
Der Gratis-Plan umfasst 6 Websites; Light erhöht auf 25, Pro ist unbegrenzt.
Fehler sind JSON: {"code": "…", "error": "Meldung"}. Häufige Codes: unauthorized (401), project_not_found (404), project_limit (403), file_too_large (413).

Claude & MCP

hdply bringt einen eingebauten MCP-Server mit — Claude Code und Claude Desktop nutzen Ihre Websites als native Tools (list_sites, create_site, get_site_html, deploy_site, get_deploy_history). Verbinden Sie Claude Code mit einem Befehl:

claude mcp add --transport http hdply https://api.app.hdply.com/mcp \
  --header "Authorization: Bearer hdply_sk_…"

Für Claude Desktop fügen Sie dies zu Ihren MCP-Einstellungen hinzu (claude_desktop_config.json):

{
  "mcpServers": {
    "hdply": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.app.hdply.com/mcp",
               "--header", "Authorization: Bearer hdply_sk_…"]
    }
  }
}

Nutzung mit KI-Agenten

Fügen Sie den Block unten zusammen mit Ihrem Schlüssel in ChatGPT, Claude oder einen beliebigen Agenten mit Shell-Zugriff ein. Danach genügt „aktualisiere meine Website“ — er weiß dann wie.

You can manage my hdply websites via its REST API.
Base URL: https://api.app.hdply.com
Auth header on every request: "Authorization: Bearer <MY_KEY>"

Endpoints:
- GET  /v1/projects                     -> list my sites
- POST /v1/projects                     -> create; JSON {"name"?, "html"?}; html goes live instantly
- GET  /v1/projects/{id}/html           -> current HTML ({id} = numeric id or subdomain)
- PUT  /v1/projects/{id}/html           -> publish new HTML (raw text/html body)
- GET  /v1/projects/{id}/deployments    -> version history

Rules: HTML max 1MB, single self-contained file preferred (inline CSS/JS).
There is no delete endpoint. Every deploy is versioned and restorable.
After publishing, the site is live at https://{subroute}.hdply.com immediately.

Maschinenlesbare Zusammenfassung für Crawler und Agenten: hdply.com/llms.txt