BunStackDocs
Indhold

Til udviklere

For udviklere

Hvad en udvikler kan bygge mod BunStack: API, webhooks, produktfeeds og egen kode i butikken, med links til referencerne.

Senest opdateret · 2 min læsning

Siderne her er til den, der bygger mod BunStack eller skriver egen kode i en butik.

Hvor: Settings › Developer. Der findes API keys, Webhooks, API docs og Developer tools.

Developer tools viser skrivebeskyttet diagnostik: sessionens JWT-claims, workspacets indstillinger og modulernes tilstand. Rækken vises kun for owner og admin.

Du vilBrugSide
Læse produkter, ordrer, kunder og anmeldelserAPI'et med en API-nøgleWebhooks og API-nøgler
Oprette og ændre produkter, sætte ordrestatusAPI'et med scope write:…Operationer
Få besked, når en ordre betales, sendes, refunderes eller annulleresWebhooksWebhooks
Sende kataloget til Google eller MetaProduktfeedetProduktfeeds
Ændre HTML, CSS eller JS for en komponentKodeeditoren i designerenEgen kode på en komponent
Slå variabler, actions og kroge i skabelonerne opSkabelonreferencenSkabelonreference
Lægge analyse- eller sporingskode i butikkenHEAD · SITE i designerenEgen CSS og kode i head

API'et kort

  • Én adresse. Hvert kald er en POST med en JSON-krop, der angiver op.
  • Nøglen sendes som Authorization: Bearer bunstack_….
  • Adressen og alle kaldkropper står under Settings › Developer › API keys › View docs.
  • En nøgle kan lave 600 kald pr. minut, heraf højst 60 skrivninger.
  • API'et kan ikke annullere, refundere eller udlevere en afhentningsordre. Gør det i admin.

Webhooks kort

  • BunStack sender en POST med JSON til din https-adresse.
  • Kroppen er signeret med HMAC-SHA256. Kontrollér signaturen, før du stoler på indholdet.
  • Leveringen sker mindst én gang. Deduplikér på delivery_id.
  • BunStack prøver igen 4 gange: efter 1, 5, 15 og 60 minutter.

Egen kode i butikken

  • Skabelonerne er HTML med variabler i dobbelte krøllede parenteser. Ingen kode kører i skabelonen.
  • Klik håndteres med data-bs-action på elementet, ikke med egne hændelseshåndterere.
  • CSS afgrænses til komponentens rod. JS kører én gang pr. sideindlæsning med roden som root.
  • Eksterne scripts i <head> kører kun fra en liste med tilladte værter og først efter samtykke til cookies.

Grænser, rensningsregler og et komplet eksempel står i Skabelonreference.