BunStackDocs
Sisältö

Kehittäjille

Kehittäjille

Mitä kehittäjä voi rakentaa BunStackia vasten: API, webhookit, tuotesyötteet ja oma koodi kaupassa, linkit viitteisiin.

Päivitetty viimeksi · 2 min lukuaika

Nämä sivut ovat niille, jotka rakentavat BunStackia vasten tai kirjoittavat omaa koodia kauppaan.

Missä: Settings › Developer. Siellä ovat API keys, Webhooks, API docs ja Developer tools.

Developer tools näyttää vain luku -diagnostiikan: istunnon JWT-claimit, workspacen asetukset ja moduulien tilan. Rivi näkyy vain rooleille owner ja admin.

HaluatKäytäSivu
Lukea tuotteita, tilauksia, asiakkaita ja arvostelujaAPI:a ja API-avaintaWebhookit ja API-avaimet
Luoda ja muuttaa tuotteita, asettaa tilauksen tilanAPI:a ja scopea write:…Operaatiot
Tietää, kun tilaus maksetaan, lähetetään, hyvitetään tai perutaanWebhookejaWebhookit
Lähettää luettelon Googlelle tai MetalleTuotesyötettäTuotesyötteet
Muuttaa komponentin HTML:ää, CSS:ää tai JS:ääSuunnittelutyökalun koodieditoriaOma koodi komponentissa
Etsiä mallien muuttujat, actionit ja koukutMalliviitettäMalliviite
Lisätä analytiikka- tai seurantakoodi kauppaanSuunnittelutyökalun kohtaa HEAD · SITEOma CSS ja head-koodi

API lyhyesti

  • Yksi osoite. Jokainen kutsu on POST, jonka JSON-rungossa on op.
  • Avain lähetetään muodossa Authorization: Bearer bunstack_….
  • Osoite ja kaikki kutsujen rungot ovat kohdassa Settings › Developer › API keys › View docs.
  • Avain saa tehdä 600 kutsua minuutissa, joista enintään 60 kirjoitusta.
  • API ei voi perua, hyvittää eikä luovuttaa noudettavaa tilausta. Tee se adminissa.

Webhookit lyhyesti

  • BunStack lähettää POST-kutsun JSONilla https-osoitteeseesi.
  • Runko on allekirjoitettu HMAC-SHA256:lla. Tarkista allekirjoitus ennen kuin luotat sisältöön.
  • Toimitus tapahtuu vähintään kerran. Poista kaksoiskappaleet kentän delivery_id perusteella.
  • BunStack yrittää uudelleen 4 kertaa: 1, 5, 15 ja 60 minuutin jälkeen.

Oma koodi kaupassa

  • Mallit ovat HTML:ää, jossa muuttujat ovat kaksinkertaisissa aaltosulkeissa. Mallissa ei ajeta koodia.
  • Napsautukset käsitellään elementin data-bs-action-attribuutilla, ei omilla tapahtumankäsittelijöillä.
  • CSS rajataan komponentin juureen. JS ajetaan kerran sivun latausta kohti, ja juuri on root.
  • Ulkoiset skriptit kohdassa <head> ajetaan vain sallittujen palvelinten listalta ja vasta evästesuostumuksen jälkeen.

Rajat, puhdistussäännöt ja täydellinen esimerkki ovat sivulla Malliviite.