BunStackDocs
Innehåll

För utvecklare

För utvecklare

Vad en utvecklare kan bygga mot BunStack: API, webhooks, produktfeeds och egen kod i butiken, med länkar till referenserna.

Senast uppdaterad · 2 min läsning

Sidorna här är för den som bygger mot BunStack eller skriver egen kod i en butik.

Var: Settings › Developer. Där finns API keys, Webhooks, API docs och Developer tools.

Developer tools visar skrivskyddad diagnostik: sessionens JWT-claims, workspacets inställningar och modulernas läge. Raden visas bara för owner och admin.

Du villAnvändSida
Läsa produkter, ordrar, kunder och recensionerAPI:t med en API-nyckelWebhooks och API-nycklar
Skapa och ändra produkter, sätta orderstatusAPI:t med scope write:…Operationer
Få veta när en order betalas, skickas, återbetalas eller avbrytsWebhooksWebhooks
Skicka katalogen till Google eller MetaProduktfeedenProduktfeeds
Ändra HTML, CSS eller JS för en komponentKodredigeraren i designernEgen kod på en komponent
Slå upp variabler, actions och krokar i mallarnaMallreferensenMallreferens
Lägga analys- eller spårningskod i butikenHEAD · SITE i designernEgen CSS och kod i head

API:t i korthet

  • API:t har en adress. Varje anrop är en POST med en JSON-kropp som anger op.
  • Nyckeln skickas som Authorization: Bearer bunstack_….
  • Adressen och alla anropskroppar står under Settings › Developer › API keys › View docs.
  • En nyckel får göra 600 anrop per minut, varav högst 60 skrivningar.
  • API:t kan inte avbryta, återbetala eller lämna ut en upphämtning. Gör det i admin.

Webhooks i korthet

  • BunStack skickar en POST med JSON till din https-adress.
  • Kroppen är signerad med HMAC-SHA256. Kontrollera signaturen innan du litar på innehållet.
  • Leveransen sker minst en gång. Deduplicera på delivery_id.
  • BunStack försöker igen 4 gånger: efter 1, 5, 15 och 60 minuter.

Egen kod i butiken

  • Mallarna är HTML med variabler i dubbla klammerparenteser. Ingen kod körs i mallen.
  • Klick hanteras med data-bs-action på elementet, inte med egna händelsehanterare.
  • CSS avgränsas till komponentens rot. JS körs en gång per sidladdning med roten som root.
  • Externa skript i <head> körs bara från en lista med tillåtna värdar och först efter cookiesamtycke.

Gränser, saneringsregler och ett komplett exempel finns i Mallreferens.