Integraatio-ohje
.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.
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äistilauksenBASKET_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.