Integrationsguide för Shopify

När API:et ska anropas

Anropa API:et från din anpassade apps backend under kassan eller från en leveransfunktion i Shopify Functions. Alltid på serversidan — aldrig från en temafil i butiken.

Kodexempel

// Server-side only — never expose your API key in browser code
async function checkDelivery(postcode, basketValueCents) {
  const res = await fetch("https://api.deliveryzone.fi/api/v1/delivery/check", {
    method: "POST",
    headers: {
      "X-Api-Key": process.env.DZ_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ destinationPostcode: postcode, basketValueCents }),
  });
  return res.json();
}

Felhantering

När canDeliver är false (eller null) innehåller svaret ett reasonCode-fält. Visa detta för kunden:

• NOT_DELIVERABLE — postnumret ligger utanför dina leveranszoner eller känns inte igen (API:et använder avsiktligt en generell kod för båda för att skydda zongränser)
• MINIMUM_ORDER_NOT_MET — varukorgens värde understiger zonens minsta ordervärde
• BASKET_VALUE_REQUIRED — ett varukorgsvärde krävs för att utvärdera denna destinations regel för minsta order eller fri frakt

Hantera alltid HTTP-fel (5xx, timeout) kontrollerat. Om API:et inte kan nås, använd felsäkert läge — avvisa antingen ordern eller tillåt manuell granskning.

Checklista för implementation

• Använd en anpassad Shopify-app eller Shopify Functions — inte temafiler
• Spara API-nyckeln i miljövariabler eller Shopify-appens hemligheter
• Testa mot en icke-produktionszon i en utvecklingsbutik före aktivering
• Hantera API-fel kontrollerat så att kassan inte kraschar vid problem
• Bekräfta avvisningsbeteendet för postnummer utanför zonen innan driftsättning

Relaterat