Integrationsguide

JavaScript / Node.js-integration

Delivery Zone API är en JSON-ändpunkt. Anropa den med fetch eller axios i Node.js — i en Express-route, Next.js API-route, Netlify Function eller i valfri JavaScript-körmiljö på serversidan.

Få min gratis API-nyckel Läs API-dokumentationen

När API:et ska anropas

Anropa API:et inuti din routhanterare på serversidan — inte i React/Vue-komponenter eller klientskript. API-nyckeln måste stanna på servern.

Viktigt: håll API-nycklar på serversidan: Anropa aldrig API:et från JavaScript i webbläsaren. Din API-nyckel måste ligga i en miljövariabel på servern. Ett prefix som NEXT_PUBLIC_ skulle exponera den — gör inte det.

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

Anropa API:et inuti en serverroute, inte i en klientkomponent
Spara nyckeln i .env som DZ_KEY — använd aldrig NEXT_PUBLIC_-prefix
Hantera fetch-fel och svar som inte är 200
Validera postnummerformatet innan API-anropet
Testa mot en icke-produktionszon innan driftsättning

Redo att lägga till postnummervalidering?

Gratis plan. Inget kreditkort. Riktig hjälp med start.

Börja gratis Läs API-dokumentationen

Relaterat

Guide för anpassad kassa Exempel: kontrollera postnummer API-dokumentation