Integraatio-ohje

PHP-integraatio

Delivery Zone API vastaanottaa JSON POST -pyynnön ja palauttaa JSON-vastauksen. Voit kutsua sitä käyttämällä funktiota file_get_contents stream-kontekstilla, cURL-kirjastoa tai WordPressissä funktiota wp_remote_post.

Hanki ilmainen API-avain Lue API-ohjeet

Milloin API:a kutsutaan

Kutsu rajapintaa PHP:n pyynnönkäsittelykoodissa — ohjaimessa, WordPress-suodattimessa tai API-päätepisteessä. Aina palvelinpäässä.

Tärkeää: pidä API-avaimet palvelimella: Älä koskaan paljasta API-avainta JavaScript-tulosteessa, HTML-lähdekoodissa tai missään asiakkaalle näkyvässä tiedostossa. Tallenna se web-juuren ulkopuoliseen konfiguraatiotiedostoon, ympäristömuuttujaan tai WordPress-asetuksiin.

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 ympäristömuuttujaan tai WordPress-asetukseen
Validoi, että postinumerossa on 5 numeroa ennen rajapinnan kutsua
Käsittele cURL- tai wp_remote_post-virheet sekä poikkeavat vastaukset
Testaa ensin ei-tuotantovyöhykkeellä
Varmista WooCommerce-hylkäystoiminta, jos käytät WooCommercea

Valmis ottamaan postinumerotarkistuksen käyttöön?

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

Aloita ilmaiseksi Lue API-ohjeet

Liittyvät aiheet

WooCommerce-integraatio Kassan tarkistuksen käyttökohde API-dokumentaatio