WooCommerce-integraatio-opas

Milloin API:a kutsutaan

Kutsu rajapintaa suodattimessa woocommerce_package_rates tai woocommerce_cart_shipping_packages — ennen kuin toimitushinnat palautetaan asiakkaalle.

Koodiesimerkki

// PHP — server-side, keep API key out of frontend
$response = wp_remote_post('https://api.deliveryzone.fi/api/v1/delivery/check', [
  'headers' => [
    'X-Api-Key'      => get_option('dz_api_key'),
    'Content-Type' => 'application/json',
  ],
  'body' => wp_json_encode([
    'destinationPostcode' => $postcode,
    'basketValueCents'    => $basket_cents,
  ]),
]);
$data = json_decode(wp_remote_retrieve_body($response), true);

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

• Tallenna API-avain WordPress-asetuksiin (options), älä teematiedostoihin
• Testaa integraatiota ei-tuotantovyöhykkeellä ennen käyttöönottoa
• Käsittele wp_remote_post-virheet ja aikakatkaisut hallitusti
• Kirjaa odottamattomat vastaukset lokiin virheenkorjausta varten
• Varmista toiminta toimitusalueen ulkopuolisilla postinumeroilla ennen julkaisua

Liittyvät aiheet