Hopp til innhold
skribbskribb

Utviklere

Butikkinnstillinger

Nettbutikk

Frakt og nedlastingsgrenser. Frakt har sin egen tilgang: en fraktrad er en pris kjøperen ender opp med å betale.

Krever at nettbutikken er slått på.

Alle sidene

Referanse

Kodeeksemplene kaller en skribb-funksjon du setter opp selv. Hent klienten for språket ditt og lim den inn én gang, så kan eksemplene under limes rett etter.

GET/v1/shop/settings

shop-settings:read

Hent frakt og nedlastingsgrenser

Svaret · 200

settingsShopSettings
Innstillingene.
Svar
{
  "settings": {
    "shipping_rates": [
      { "service": "Standard", "max_grams": 1000, "amount_ore": 7900, "countries": [] },
      { "service": "Standard", "max_grams": null, "amount_ore": 14900, "countries": [] }
    ],
    "shipping_countries": ["NO"],
    "download_ttl_hours": 72,
    "download_max_count": 5
  }
}
# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/shop/settings"

PATCH/v1/shop/settings

shop-settings:write

Endre dem, felt for felt

Ekte delvis endring: felt du ikke sender, står som de er. En rad vi ikke kan bruke, blir avvist med 422 og en kode som navngir feltet. Vi lagrer aldri halve tabellen.

Bodyen du sender

shipping_ratesShippingRateInput[]
Hele fraktabellen. Send en tom liste for å tømme den.
shipping_countriesstring[]
Hele landlista. Kan ikke være tom: en butikk uten land kan ikke selge noe.
download_ttl_hoursinteger
1 til 8760.
download_max_countinteger
1 til 1000.

Svaret · 200

settingsShopSettings
Innstillingene slik de nå er.
# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/shop/settings" \
  -X PATCH \
  -H "content-type: application/json" \
  -d '{
    "shipping_rates": [
      {}
    ],
    "shipping_countries": [
      "NO"
    ],
    "download_ttl_hours": 24
  }'

Objekter

ShopSettings

Frakt og nedlastingsgrenser for butikken.

Felter

shipping_ratesShippingRate[]
Fraktabellen. Tom liste betyr at ingen fysisk vare kan sendes noe sted.
shipping_countriesstring[]
Landene kassa i det hele tatt tilbyr, ISO-3166 alfa-2.
download_ttl_hoursinteger
Hvor lenge en nedlastingslenke virker etter kjøpet. 1 til 8760.
download_max_countinteger
Hvor mange ganger den kan brukes. 1 til 1000.

ShippingRate

En fraktrad. Den billigste raden som passer vekten og landet, vinner.

Felter

servicestring
Navnet kjøperen ser i kassa. Inntil 60 tegn.
max_gramsinteger | null
Øvre vektgrense raden gjelder til. null betyr uansett vekt, altså en flat rate. 1 til 1000000.
amount_oreinteger
Frakten i øre. 0 til 10000000.
countriesstring[]
Landene raden gjelder for, ISO-3166 alfa-2. Tom liste betyr alle land du sender til. Inntil 50.

ShippingRateInput

En fraktrad slik du sender den inn.

Felter

servicestringpåkrevd
Navnet kjøperen ser i kassa. Inntil 60 tegn, og kan ikke være tomt.
amount_oreintegerpåkrevd
Frakten i øre. 0 til 10000000.
max_gramsinteger | null
Øvre vektgrense. Utelatt eller null betyr uansett vekt. 1 til 1000000 ellers.
countriesstring[]
ISO-3166 alfa-2. Utelatt eller tom betyr alle land du sender til. Inntil 50.

← Alle rutene