Hopp til innhold
skribbskribb

Utviklere

Butikkinnstillinger

Nettbutikk

Frakt og nedlastingsgrenser.

Krever at nettbutikken er slått på.

Alle sidene

Referanse

Kodeeksemplene kaller en skribb-funksjon. Hent klienten for språket ditt →

GET/v1/shop/settings

shop-settings:read

Hent frakt og nedlastingsgrenser

Svaret · 200

settingsShopSettings
Innstillingene.
Svar
{
  "settings": {
    "shipping_rates": [
      { "service": "Norgespakke liten", "max_grams": 5000, "amount_ore": 7900, "countries": [], "carrier": "posten", "delivery_mode": "mailbox" },
      { "service": "Norgespakke stor", "max_grams": null, "amount_ore": 14900, "countries": [], "carrier": "posten", "delivery_mode": "pickup-point" }
    ],
    "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

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.
carrierstring | null
Hvem som frakter den: posten, postnord eller helthjem. null betyr at butikken ikke har sagt det.
delivery_modestring | null
Hvordan kjøperen får pakken: mailbox, pickup-point eller home. null betyr at butikken ikke har sagt det.

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.
carrierstring | null
posten, postnord eller helthjem. Utelatt eller null lar raden stå uten fraktselskap. En annen verdi avvises.
delivery_modestring | null
mailbox, pickup-point eller home. Utelatt eller null lar raden stå uten leveringsmåte. En annen verdi avvises.

← Alle rutene