Vad som går – och enligt vilka regler
Via API:et skapar, ändrar och publicerar du det du annars gör i verktygen. Samma regler gäller: dina paketgränser, din AI-stapel, ett fullständigt varumärke före publicering, obrutna fakturanummer och kontrollen av varje uppladdad bild. Det som inte går i verktyget går inte heller här.
Om något avvisas står det i type en fast engelsk kod som ditt program kan agera på – till exempel plan_limit_reached, brand_incomplete eller ai_quota_exhausted – och i detail den mening som verktyget också skulle visa dig.
{
"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: …"
}
}Behörigheterna
Varje område har en behörighet för att läsa och en för att skriva: sites:read och sites:write för webbplatser, domains:read och dns:write för domäner och DNS-poster, invoices:read och invoices:write för kunder, fakturor och offerter, media:read och media:write för MediaStudio, brand:read för dina varumärken. Välj dem när du skapar nyckeln under ”Vad får den här nyckeln göra?”.
Webbplatser
POST /v1/sites bygger en hel webbplats utifrån en mening – som utkast. Det tar oftast 20 till 60 sekunder och förbrukar AI-saldo, precis som i WebSiteBuilder. POST /v1/sites/{id}/edit ändrar en sida i utkastet enligt dina instruktioner. Ingenting går online förrän med POST /v1/sites/{id}/publish; POST /v1/sites/{id}/unpublish tar webbplatsen offline igen utan att något går förlorat.
brand_id anger det varumärke vars logotyp och företagsuppgifter webbplatsen visar. Om du bara har ett varumärke följer varje webbplats det automatiskt – då står dess nummer där och brand_assigned är false. Med flera varumärken visar en webbplats logotyp och företagsuppgifter endast från det varumärke som du har kopplat den till; utan koppling är 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."}'Skicka med en Idempotency-Key vid AI-anropen. Om anslutningen bryts upprepar du med samma nyckel och får den webbplats som redan har byggts – utan att betala en gång till.
DNS-poster
GET /v1/domains listar dina domäner vars DNS ligger hos KENJTEC. Under dem skapar du poster (A, AAAA, CNAME, MX, TXT, NS), ersätter dem med PATCH och raderar dem – med samma kontroller som i DomainStudio.
Poster som KENJTEC har skapat för något av dina verk har managed: true. Dem ändrar API:et inte; det gör du i DomainStudio, där konsekvenserna visas.
Fakturor och offerter
POST /v1/customers skapar en kund, POST /v1/invoices ett utkast – en faktura eller en offert. Summorna beräknar KENJTEC; du skickar antal, styckpris i cent och skattesats per rad.
POST /v1/invoices/{id}/issue utfärdar den: dokumentet får nästa nummer utan lucka och är därefter låst. Att korrigera innebär att annullera – POST /v1/invoices/{id}/cancel skapar en kreditfaktura med eget nummer. Ingenting raderas.
Ladda upp medier
Uppladdning sker i två steg, som i MediaStudio. POST /v1/media/uploads ger dig en adress och rubrikerna; dit skickar du filen med PUT. Därefter kontrollerar POST /v1/media/{id}/confirm det som har kommit fram, och först då går filen att nå på sin adress.
Tillåtna är JPEG, PNG, WebP, GIF, PDF, MP4 och WebM. En bild som inte klarar innehållskontrollen avvisas med 422.
Läsa ditt varumärke
GET /v1/brands returnerar dina varumärken från BrandStudio: namn, logotyp, färger, typsnitt, företagsuppgifter och kanaler. På så sätt kan dina egna program bygga med samma profil som dina KENJTEC-verk.