JavaScript / Node.js-integration

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.

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

Relaterat