API und API-Keys

Key erstellen

1. Unter API-Keys einen Namen vergeben (z. B. „Deployment“), Rechte wählen – „lesen und ändern“ oder „nur lesen“ (z. B. für Monitoring) – und wie lange er gilt (30 Tage, 90 Tage, 1 Jahr oder unbegrenzt).
2. Den Key (khcdn_…) sofort kopieren – er wird nur dieses eine Mal angezeigt. Wir speichern nur einen Fingerabdruck.
3. Nicht mehr gebraucht oder verloren? Widerrufen und neu erstellen.

Beispiele

curl https://portal.kernhosting.com/v1/domains \
  -H "Authorization: Bearer khcdn_…"

curl -X POST https://portal.kernhosting.com/v1/domains/<id>/purges \
  -H "Authorization: Bearer khcdn_…" -H "Content-Type: application/json" \
  -d '{"type":"url","url":"https://www.ihre-domain.de/preise"}'

curl -X PATCH https://portal.kernhosting.com/v1/domains/<id>/security \
  -H "Authorization: Bearer khcdn_…" -H "Content-Type: application/json" \
  -d '{"maintenance":{"enabled":false}}'

curl -X POST https://portal.kernhosting.com/v1/dns/zones/<zone-id>/records \
  -H "Authorization: Bearer khcdn_…" -H "Content-Type: application/json" \
  -d '{"name":"www","type":"A","content":"203.0.113.10","ttl":3600}'

Regeln der API

• Alle Antworten sind JSON; Anfragen mit Body senden Content-Type: application/json.
• Fehler haben immer die Form {"error":{"code":"…","message":"…"}}, bei Eingabefehlern mit details je Feld.
• Bis zu 600 Anfragen pro Minute je Key, darüber 429.
• Fremde oder gelöschte Objekte antworten mit 404.

Die wichtigsten Endpunkte

Alle Endpunkte mit Feldern und Beispielen stehen in der API-Dokumentation; die Beschreibung im Format OpenAPI unter /v1/openapi.json (für Postman, Insomnia oder einen eigenen Client).