Osoitteen validointi

Usein kysytyt kysymykset API:sta

Plugins

Mitä lisäosia on saatavilla?

Löydät luettelon liitännäisistä Shopware-, Magento-, WooCommerce- ja muille tuotteille API-toteutussivulta.

Miksi joudun maksamaan lisämaksua joistakin lisäosista?

Ilmaiset laajennukset tarjotaan sellaisenaan ilman tukea. Koska eri alustoille on olemassa monia erilaisia lisäosia, voi olla haastavaa saada kaikki toimimaan yhdessä. Joidenkin ilmaisten liitännäisten lähdekoodi on siksi vapaasti saatavilla, jotta toteutukseen omistautuneet kumppanit voivat kehittää sivustoa haluamallaan tavalla.

Maksullisia versioita tarjoavat kolmannet osapuolet, jotka tarjoavat tukea liitännäisilleen. Tällöin kahden eri osapuolen välillä tehdään sopimus. Postcode.nl:n kanssa API:n osalta ja kolmannen osapuolen kanssa lisäosan osalta. Nämä sopimukset ovat toisistaan riippumattomia.

Lisäosaa ei ole listattu?

Ei hätää, API voidaan integroida myös teknisen dokumentaation avulla.

Test-API

Miten voin testata API:ta?

Kun luot tilin, tämä on aina ensimmäinen testikäyttö, joten et ole vielä tekemässä tilausta. Sinulla on kuusi kuukautta aikaa testata APIa, ja testikäytössä suoritettavien validointien määrä on rajoitettu.

Testin jälkeen sinun on ilmoitettava meille, että olet valmis ja tilaus voi alkaa. Tämän jälkeen valitset tilauksen, jonka haluat tehdä.

Enemmän validointeja kuin tilauksia

Miksi API-tililläni näkyy enemmän osumia kuin tilauksia?

Käytännössä osoitepyyntöjen määrä ei koskaan vastaa täsmälleen verkkokaupan tilausten määrää. Tähän voi olla useita syitä, kuten mikä lisäosa on käytössä tai omassa toteutuksessasi.

Yleisimmät syyt ovat:

• Samoja osoitteita pyydetään usein useaan kertaan, esimerkiksi siksi, että käyttäjä syöttää saman osoitteen useaan kertaan tai siksi, että verkkokauppaohjelmisto tarkistaa osoitteen useassa paikassa. Näin ollen yksi komento voi johtaa moniin kyselyihin. Säilyttämällä vahvistetun osoitteen väliaikaisesti (esimerkiksi jopa viikon ajan) estät palvelumme tarpeettoman saman osoitteen keräämisen.
• Pyynnöt, joissa on väärä postinumero tai talon numero: Nämä pyynnöt eivät koskaan johda osoitteen saamiseen. Tarkista ennen kyselyn aloittamista, että postinumero on täydellinen ja oikeassa muodossa ja että talon numero alkaa numeroilla. Varmista myös, että osoitetta ei voida tarkistaa ennen kuin käyttäjä on kirjoittanut sen loppuun.

Validointirajan ylittäminen

Mitä tapahtuu, jos ylitän nykyisen tasorajani?

Ensinnäkin, älä huoli, API ei poistu käytöstä, jos ylität rajasi. Mielestämme on tärkeää, että API toimii, jotta asiakkaasi voivat jatkaa tilausten tekemistä ja jotta prosessisi eivät keskeydy.

Jotta pysyt ajan tasalla käytöstäsi, ilmoitukset lähetetään sähköpostitse. Tämä tapahtuu 50, 80 ja 100 %:n käyttörajan kohdalla.

Jos tilaus on 100 %, se päivitetään automaattisesti oikealle ja vastaavalle tasolle. Järjestelmä tarkastelee edellisen kauden validointien määrää nykyisen tilauskauden aikana ja tekee ennusteen odotettavissa olevien pyyntöjen määrästä jäljellä olevan tilauskauden aikana.

Jotta ennuste voidaan arvioida oikein, päivitystä ei tehdä tilauskauden ensimmäisen kuukauden aikana.

Aiotko ylittää tason 5?

Ennusteen perusteella odotettavissa oleva kulutus laskutetaan 10 %:n lohkoina tasosta 5 (eli 100 euroa tasoa kohti), ja lisäksi sovelletaan tämän tason validointikohtaisia yksikköhintoja.

API-tilini ja tilaukseni

Miten hallinnoin API-tiliäni ja tilaustani?

Valtakirjaa koskeva pyyntö

Kun kirjaudut ylläpitäjätililläsi hallinta-alueelle, löydät valikosta kohdan nimeltä "Credentials".

Jos napsautat sitä, näet avaimen. Salaisuus lähetettiin tuolloin vain sähköpostitse, eikä sitä voi hakea. Tällä samalla sivulla on oikeassa yläkulmassa painike, jolla voit luoda uuden Avaimen ja Salaisuuden. Ne lähetetään sitten automaattisesti sähköpostitse.

Muokkaa laskun ja/tai tilin tietoja

Valitettavasti tämä ei ole vielä mahdollista hallintoympäristön kautta. Jos haluat tehdä muutoksia, ota meihin yhteyttä suoraan sähköpostitse.

Sopimuksen jatkaminen

Jos haluat jatkaa ja aktivoida vanhan sopimuksen, ota meihin yhteyttä myös sähköpostitse.

Tilauksen peruuttaminen

API:n peruuttaminen voidaan tehdä kirjautumalla hallinta-alueelle, ja se on tilin ylläpitäjän tehtävä.

"Hallitse"-valikossa on "Tilaus"-osio. Tilauksen voi peruuttaa tässä kohtaa seuraavassa tilaisuudessa.

Osoitteen automaattinen täydennys API vs. hollantilainen postinumero API

Mitä eroa on Address Autocomplete API:lla ja Dutch Postcode API:lla?

Osoitteiden automaattisen täydennyksen API:n avulla voit hakea kaikkien käytettävissä olevien maiden osoitteet. Tämä API on toiminnallisuuksiltaan laajempi kuin Alankomaiden postinumero API. Voit esimerkiksi täydentää osoitteita postinumeron ja talon numeron perusteella, mutta voit myös täydentää niitä automaattisen automaattisen täydennystoiminnon avulla. Tämä on hyödyllistä, jos syötetään osoitteita, joiden postinumero ei ole tiedossa. Alankomaiden postinumero API toimii siten, että täydellinen osoite saadaan ainoastaan postinumeron ja talon numeron perusteella.

Voinko käyttää vain yhtä API:ta?

Voit tietysti käyttää API:ita rinnakkain. Esimerkiksi osoitteet voidaan hakea kaikkien asiakkaidesi osalta käyttämällä Address Autocomplete API:ta ja erityisesti hollantilaisten asiakkaiden osalta Dutch Postcode API:ta. Jotkin lisäosat tekevät tämän automaattisesti, ne valitsevat oikean API:n, kun osoitepyyntö tehdään.

Miksi Address Autocomplete API on kalliimpi kuin Dutch Postcode API?

Osoitteiden automaattisen täydennysliittymän kautta haettujen osoitteiden yksikköhinta on korkeampi, koska tämä sovellusliittymä tarjoaa enemmän ominaisuuksia. Tätä hintaa sovelletaan myös silloin, kun hollantilainen postinumero ja talon numero haetaan Address Autocomplete API:lla.