Was geht — und nach welchen Regeln
Über die API legst du an, änderst und veröffentlichst, was du sonst in den Tools tust. Es gelten dieselben Regeln: deine Paketgrenzen, dein KI-Balken, eine vollständige Marke vor dem Veröffentlichen, lückenlose Rechnungsnummern und die Prüfung jedes hochgeladenen Bildes. Was im Tool nicht geht, geht hier auch nicht.
Wird etwas abgelehnt, steht in type eine feste englische Kennung, an der dein Programm entscheidet — etwa plan_limit_reached, brand_incomplete oder ai_quota_exhausted —, und in detail der Satz, den dir auch das Tool zeigen würde.
{
"error": {
"type": "brand_incomplete",
"message": "The brand needs a name, an address and an email or phone number before anything is published.",
"detail": "Bevor diese Website online geht, muss klar sein, wer dahintersteht. Es fehlt: …"
}
}Die Rechte
Jeder Bereich hat ein Recht zum Lesen und eines zum Schreiben: sites:read und sites:write für Websites, domains:read und dns:write für Domains und DNS-Einträge, invoices:read und invoices:write für Kunden, Rechnungen und Angebote, media:read und media:write für das MediaStudio, brand:read für deine Marken. Wähle sie beim Anlegen des Schlüssels unter „Was darf dieser Schlüssel?“.
Websites
POST /v1/sites baut aus einem Satz eine ganze Website — als Entwurf. Das dauert meist 20 bis 60 Sekunden und verbraucht KI-Guthaben, wie im WebSiteBuilder. POST /v1/sites/{id}/edit ändert eine Seite des Entwurfs nach deiner Anweisung. Online geht erst etwas mit POST /v1/sites/{id}/publish; POST /v1/sites/{id}/unpublish nimmt die Website wieder aus dem Netz, ohne etwas zu verlieren.
brand_id nennt die Marke, deren Logo und Firmenangaben die Website zeigt. Hast du nur eine Marke, folgt ihr jede Website von selbst — dann steht dort ihre Nummer und brand_assigned ist false. Mit mehreren Marken zeigt eine Website Logo und Firmenangaben nur von der Marke, der du sie zugeordnet hast; ohne Zuordnung ist brand_id null.
curl https://api.kenjtec.com/v1/sites \
-H "Authorization: Bearer kt_api_…" \
-H "Idempotency-Key: cafe-lumen-2026-10" \
-H "Content-Type: application/json" \
-d '{"brief": "Café Lumen in Lissabon: Frühstück, eigene Kaffeebohnen, Tische zum Reservieren."}'Schick bei den KI-Wegen eine Idempotency-Key mit. Reißt die Verbindung ab, wiederholst du mit derselben Kennung und bekommst die schon gebaute Website — ohne ein zweites Mal zu zahlen.
DNS-Einträge
GET /v1/domains nennt deine Domains, deren DNS bei KENJTEC liegt. Darunter legst du Einträge an (A, AAAA, CNAME, MX, TXT, NS), ersetzt sie mit PATCH und löschst sie — mit denselben Prüfungen wie im DomainStudio.
Einträge, die KENJTEC für eines deiner Werke gesetzt hat, tragen managed: true. Die ändert die API nicht; das geht im DomainStudio, wo die Folgen dabeistehen.
Rechnungen und Angebote
POST /v1/customers legt einen Kunden an, POST /v1/invoices einen Entwurf — eine Rechnung oder ein Angebot. Die Summen rechnet KENJTEC; du schickst Menge, Einzelpreis in Cent und Steuersatz je Zeile.
POST /v1/invoices/{id}/issue stellt aus: Der Beleg bekommt die nächste Nummer ohne Lücke und ist danach fest. Korrigieren heißt stornieren — POST /v1/invoices/{id}/cancel legt eine Stornorechnung mit eigener Nummer an. Gelöscht wird nichts.
Medien hochladen
Hochladen geht in zwei Schritten, wie im MediaStudio. POST /v1/media/uploads nennt dir eine Adresse und die Kopfzeilen; dorthin schickst du die Datei mit PUT. Danach prüft POST /v1/media/{id}/confirm, was angekommen ist, und erst dann ist die Datei unter ihrer Adresse erreichbar.
Erlaubt sind JPEG, PNG, WebP, GIF, PDF, MP4 und WebM. Ein Bild, das die Inhaltsprüfung nicht besteht, wird mit 422 abgelehnt.
Deine Marke lesen
GET /v1/brands liefert deine Marken aus dem BrandStudio: Name, Logo, Farben, Schriften, Firmenangaben und Kanäle. So bauen deine eigenen Programme im selben Auftritt wie deine KENJTEC-Werke.