.NET / C#-integration

Delivery Zone API är en enkel JSON-ändpunkt över HTTP. Anropa den via HttpClient i valfri .NET-applikation — såsom ASP.NET Core, Azure Functions eller en bakgrundstjänst.

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

När API:et ska anropas

Anropa API:et från din ASP.NET-kontroller eller tjänstelager innan ordern bekräftas. Exponera aldrig API-nyckeln och dirigera inte anropet genom klienten.

Viktigt: håll API-nycklar på serversidan: Spara API-nyckeln i miljövariabler eller i appsettings.json (via Secret Manager). Hårdkoda den aldrig och exponera den inte i klientkod.

Kodexempel

// .NET / C# — server-side, inject via IHttpClientFactory
var payload = new {
  destinationPostcode = postcode,
  basketValueCents = basketCents,
};
var response = await httpClient.PostAsJsonAsync(
  "https://api.deliveryzone.fi/api/v1/delivery/check",
  payload
);
var result = await response.Content.ReadFromJsonAsync<DeliveryCheckResult>();
if (!result.CanDeliver) {
  // Reject order: result.ReasonCode
}

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

Injicera HttpClient via beroendeinjektion (IHttpClientFactory)
Spara API-nyckeln i miljövariabler eller user secrets
Hantera HTTP-fel och timeouts med try/catch
Testa mot en icke-produktionszon först
Bekräfta avvisningsbeteendet i din stagingmiljö

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 API-dokumentation Exempel: API-nyckel på serversidan