Kom i gang: API-nøgle og første kald.

Hvad API'en kan

KENJTEC API'en giver dine egne programmer adgang til din konto: læse formularer og deres svar, butikker og ordrer — og skrive: bygge og udgive websites, administrere DNS-poster, skrive fakturaer, uploade medier. Derudover er der webhooks — vi kontakter din server, så snart der sker noget. Og din egen AI kan arbejde via MCP med den samme nøgle.

Adressen er https://api.kenjtec.com/v1. API'en er inkluderet i alle betalte pakker uden merpris.

Oprette en nøgle

Hvert program logger ind med sin egen API-nøgle. En nøgle har rettigheder: forms:read læser formularer og svar, orders:read læser butikker og ordrer, webhooks:manage opretter og sletter webhooks. Til de skrivende endpoints findes der egne rettigheder for hvert område. Giv hvert program sin egen nøgle — så kan du tilbagekalde én uden at forstyrre de andre.

1. 1Åbn dashboardet, og vælg området Udvikler under „Indstillinger“.
2. 2Giv nøglen et navn under „API-nøgler“, for eksempel „Lagersynkronisering“.
3. 3Vælg under „Hvad må denne nøgle?“ kun de rettigheder, programmet har brug for.
4. 4Klik på „Opret nøgle“, og kopiér nøglen med det samme.

Nøglen vises præcis én gang. Vi gemmer kun en kontrolsum — hvis den går tabt, tilbagekalder du den med „Tilbagekald“ og opretter en ny.

Det første kald

Send nøglen med i headeren Authorization i hver forespørgsel. /v1/me fortæller dig, hvilken konto nøglen tilhører, og hvilke rettigheder den har.

curl https://api.kenjtec.com/v1/me \
  -H "Authorization: Bearer kt_api_…"

{
  "id": 1042,
  "object": "account",
  "email": "ana@deine-firma.com",
  "handle": "cafe-lumen",
  "address": "https://cafe-lumen.kenjtec.ai",
  "key": { "name": "Lager-Abgleich", "scopes": ["orders:read"] }
}

Endpointene

Disse endpoints findes. Den fuldstændige, maskinlæsbare beskrivelse findes på https://api.kenjtec.com/openapi.json — ud fra den kan der genereres programbiblioteker til ethvert programmeringssprog.

GET    /v1/me
GET    /v1/forms
GET    /v1/forms/{id}
GET    /v1/forms/{id}/responses
GET    /v1/forms/{id}/responses/{id}
GET    /v1/shops
GET    /v1/orders          ?shop_id=  &status=  &payment_status=
GET    /v1/orders/{id}
GET    /v1/webhooks
POST   /v1/webhooks
DELETE /v1/webhooks/{id}

GET    /v1/sites
GET    /v1/sites/{id}
POST   /v1/sites
POST   /v1/sites/{id}/edit
POST   /v1/sites/{id}/publish
POST   /v1/sites/{id}/unpublish
GET    /v1/domains
GET    /v1/domains/{id}/dns_records
POST   /v1/domains/{id}/dns_records
PATCH  /v1/domains/{id}/dns_records/{id}
DELETE /v1/domains/{id}/dns_records/{id}
GET    /v1/customers
POST   /v1/customers
GET    /v1/invoices        ?kind=invoice|quote
GET    /v1/invoices/{id}
POST   /v1/invoices
POST   /v1/invoices/{id}/issue
POST   /v1/invoices/{id}/cancel
GET    /v1/media
POST   /v1/media/uploads
POST   /v1/media/{id}/confirm
GET    /v1/brands
GET    /v1/brands/{id}

Filer fra formularsvar vises med deres navn, ikke med en adresse. Du kan downloade dem i FormBuilder.

Lister, beløb, tidspunkter

Lister kommer med de nyeste først, højst 100 poster pr. kald (limit, standard 25). For at få den næste side sender du id'et for den sidste post med som starting_after; has_more fortæller, om der kommer mere.

Beløb er heltal i valutaens mindste enhed — cent for euro, hele yen for yen. Tidspunkter angives i UTC efter ISO 8601.

curl "https://api.kenjtec.com/v1/orders?payment_status=paid&limit=50" \
  -H "Authorization: Bearer kt_api_…"

Fejl og grænser

Alle fejl har samme form: et objekt error med type og message. 401 betyder: Nøglen mangler, er forkert eller tilbagekaldt. 403 betyder: Nøglen mangler en rettighed — eller kontoen har ikke længere en betalt pakke (type plan_required). 404 betyder: Det findes ikke, eller det tilhører ikke din konto.

Hver nøgle kan foretage 120 forespørgsler i minuttet. Ud over det svarer API'en med 429 og angiver i Retry-After antallet af sekunder til næste forsøg.

{
  "error": {
    "type": "permission_error",
    "message": "This API key lacks the scope 'orders:read'."
  }
}

API'en accepterer udelukkende nøgler, aldrig dit login i browseren. En nøgle hører hjemme på din server — aldrig i et website eller en app, som andre downloader.