.NET / C# -integraatio

Delivery Zone API on suoraviivainen JSON-päätepiste HTTP:n yli. Voit kutsua sitä luokan HttpClient avulla mistä tahansa .NET-sovelluksesta — kuten ASP.NET Coresta, Azure Functionsista tai taustapalvelusta.

Hanki ilmainen API-avain Lue API-ohjeet

Milloin API:a kutsutaan

Kutsu rajapintaa ASP.NET-ohjaimesta (controller) tai palvelukerroksesta ennen tilauksen vahvistamista. Älä koskaan paljasta API-avainta tai reititä kutsua asiakassovelluksen kautta.

Tärkeää: pidä API-avaimet palvelimella: Tallenna API-avain ympäristömuuttujiin tai tiedostoon appsettings.json (käyttäen Secret Manageria). Älä koskaan kovakoodaa sitä tai paljasta sitä asiakaspuolen koodissa.

Koodiesimerkki

// .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
}

Virheenkäsittely

Kun canDeliver on false (tai null), vastaus sisältää reasonCode-kentän. Näytä tämä asiakkaalle:

NOT_DELIVERABLE — postinumero on toimitusalueidesi ulkopuolella tai sitä ei tunnisteta (rajapinta käyttää tarkoituksella yhtä yleistä koodia molemmille vyöhykerajojen suojaamiseksi)
MINIMUM_ORDER_NOT_MET — ostoskorin arvo alittaa vyöhykkeen vähimmäistilauksen
BASKET_VALUE_REQUIRED — ostoskorin arvo tarvitaan tämän kohteen vähimmäistilaus- tai ilmaistoimitussäännön arvioimiseksi

Käsittele aina HTTP-virheet (5xx, aikakatkaisu) hallitusti. Jos rajapinta ei ole tavoitettavissa, toimi turvallisesti — hylkää tilaus tai ohjaa se manuaaliseen tarkistukseen.

Käyttöönottolista

Injektoi HttpClient riippuvuuksienhallinnan kautta (IHttpClientFactory)
Tallenna API-avain ympäristömuuttujiin tai käyttäjän salaisuuksiin
Käsittele HTTP-virheet ja aikakatkaisut try/catch-rakenteella
Testaa ensin ei-tuotantovyöhykkeellä
Varmista hylkäystoiminta staging-ympäristössäsi

Valmis ottamaan postinumerotarkistuksen käyttöön?

Ilmainen aloitus. Ei luottokorttia. Aito käyttöönottoapu.

Aloita ilmaiseksi Lue API-ohjeet

Liittyvät aiheet

Räätälöidyn kassan opas API-dokumentaatio Esimerkki: API-avaimen suojaus palvelimella