Wat kan er — en volgens welke regels
Via de API maak je aan, wijzig je en publiceer je wat je anders in de tools doet. Er gelden dezelfde regels: je pakketlimieten, je AI-balk, een volledig merk vóór het publiceren, doorlopende factuurnummers zonder gaten en de controle van elke geüploade afbeelding. Wat in de tool niet kan, kan hier ook niet.
Wordt iets geweigerd, dan staat in type een vaste Engelse code waarop je programma kan beslissen — zoals plan_limit_reached, brand_incomplete of ai_quota_exhausted — en in detail de zin die de tool je ook zou tonen.
{
"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: …"
}
}De rechten
Elk onderdeel heeft een recht om te lezen en een om te schrijven: sites:read en sites:write voor websites, domains:read en dns:write voor domeinen en DNS-records, invoices:read en invoices:write voor klanten, facturen en offertes, media:read en media:write voor MediaStudio, brand:read voor je merken. Kies ze bij het aanmaken van de sleutel onder “Wat mag deze sleutel?”.
Websites
POST /v1/sites bouwt uit één zin een complete website — als concept. Dat duurt meestal 20 tot 60 seconden en verbruikt AI-tegoed, net als in WebSiteBuilder. POST /v1/sites/{id}/edit wijzigt een pagina van het concept volgens je instructie. Er gaat pas iets online met POST /v1/sites/{id}/publish; POST /v1/sites/{id}/unpublish haalt de website weer offline zonder dat er iets verloren gaat.
brand_id noemt het merk waarvan de website het logo en de bedrijfsgegevens toont. Heb je maar één merk, dan volgt elke website dat merk vanzelf — dan staat daar het nummer ervan en is brand_assigned false. Met meerdere merken toont een website logo en bedrijfsgegevens alleen van het merk waaraan je haar hebt toegewezen; zonder toewijzing is 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."}'Stuur bij de AI-routes een Idempotency-Key mee. Valt de verbinding weg, dan herhaal je het verzoek met dezelfde sleutel en krijg je de al gebouwde website — zonder een tweede keer te betalen.
DNS-records
GET /v1/domains toont je domeinen waarvan de DNS bij KENJTEC staat. Daaronder maak je records aan (A, AAAA, CNAME, MX, TXT, NS), vervang je ze met PATCH en verwijder je ze — met dezelfde controles als in DomainStudio.
Records die KENJTEC voor een van je werken heeft ingesteld, hebben managed: true. Die wijzigt de API niet; dat doe je in DomainStudio, waar de gevolgen erbij staan.
Facturen en offertes
POST /v1/customers maakt een klant aan, POST /v1/invoices een concept — een factuur of een offerte. De totalen berekent KENJTEC; jij stuurt per regel de hoeveelheid, de stukprijs in centen en het btw-tarief.
POST /v1/invoices/{id}/issue geeft het document uit: het krijgt het volgende nummer zonder gat en ligt daarna vast. Corrigeren betekent annuleren — POST /v1/invoices/{id}/cancel maakt een creditfactuur met een eigen nummer aan. Er wordt niets verwijderd.
Media uploaden
Uploaden gaat in twee stappen, net als in MediaStudio. POST /v1/media/uploads geeft je een adres en de headers; daarheen stuur je het bestand met PUT. Daarna controleert POST /v1/media/{id}/confirm wat er is aangekomen, en pas dan is het bestand op zijn adres bereikbaar.
Toegestaan zijn JPEG, PNG, WebP, GIF, PDF, MP4 en WebM. Een afbeelding die niet door de inhoudscontrole komt, wordt geweigerd met 422.
Je merk lezen
GET /v1/brands levert je merken uit BrandStudio: naam, logo, kleuren, lettertypen, bedrijfsgegevens en kanalen. Zo bouwen je eigen programma's in dezelfde huisstijl als je KENJTEC-werken.