BunStackDocs
Innhold

For utviklere

For utviklere

Hva en utvikler kan bygge mot BunStack: API, webhooks, produktfeeder og egen kode i butikken, med lenker til referansene.

Sist oppdatert · 2 min lesing

Sidene her er for den som bygger mot BunStack eller skriver egen kode i en butikk.

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

Developer tools viser skrivebeskyttet diagnostikk: øktens JWT-claims, workspacets innstillinger og modulenes tilstand. Raden vises bare for owner og admin.

Du vilBrukSide
Lese produkter, ordrer, kunder og anmeldelserAPI-et med en API-nøkkelWebhooks og API-nøkler
Opprette og endre produkter, sette ordrestatusAPI-et med scope write:…Operasjoner
Få vite når en ordre betales, sendes, refunderes eller kanselleresWebhooksWebhooks
Sende katalogen til Google eller MetaProduktfeedenProduktfeeder
Endre HTML, CSS eller JS for en komponentKoderedigereren i designerenEgen kode på en komponent
Slå opp variabler, actions og kroker i maleneMalreferansenMalreferanse
Legge analyse- eller sporingskode i butikkenHEAD · SITE i designerenEgen CSS og kode i head

API-et i korthet

  • Én adresse. Hvert kall er en POST med en JSON-kropp som angir op.
  • Nøkkelen sendes som Authorization: Bearer bunstack_….
  • Adressen og alle kallkropper står under Settings › Developer › API keys › View docs.
  • En nøkkel kan gjøre 600 kall per minutt, hvorav høyst 60 skrivinger.
  • API-et kan ikke kansellere, refundere eller levere ut en henteordre. Gjør det i admin.

Webhooks i korthet

  • BunStack sender en POST med JSON til https-adressen din.
  • Kroppen er signert med HMAC-SHA256. Kontroller signaturen før du stoler på innholdet.
  • Leveransen skjer minst én gang. Dedupliser på delivery_id.
  • BunStack prøver igjen 4 ganger: etter 1, 5, 15 og 60 minutter.

Egen kode i butikken

  • Malene er HTML med variabler i doble krøllparenteser. Ingen kode kjører i malen.
  • Klikk håndteres med data-bs-action på elementet, ikke med egne hendelseshåndterere.
  • CSS avgrenses til komponentens rot. JS kjører én gang per sidelasting med roten som root.
  • Eksterne skript i <head> kjører bare fra en liste med tillatte verter og først etter samtykke til cookies.

Grenser, rensingsregler og et komplett eksempel står i Malreferanse.