API-Dokumentation

Zuletzt aktualisiert: 2026-07-05

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").

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 20 Websites; 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