Artikkeli julkaistu 14.10.2024.. Artikkelia päivitetty 3.3.2025.
Tähän artikkeliin on koostettu rajapintoihin liittyvät huomiot ja usein kysytyt kysymykset, liittyen julkipilveen siirtymiseen.
Muista huomioista julkipilveen siirtymisessä pääset lukemaan tästä artikkelistamme.
Meillä on 3. osapuolen sovellus, joka käyttää REST-rajapintaa. Muuttuuko tässä jotain?
Kyllä. Uusi osoite siirron jälkeen on rest.lemon.fi.
Toinen muutos liittyy kirjautumiseen. Kirjautumisessa on tähänkin saakka käytetty parametria ”database”. Parametrin merkitys muuttuu ja se tarkoittaa yrityksen organisaatiotunnistetta. Organisaatiotunnisteen löydät käyttäjähallinnasta yrityksen tiedoista otsikolla ”Organisaatiotunniste” (katso kuva alla).
Pääkäyttäjän tulee ilmoittaa uusi REST-osoite sekä Organisaatiotunniste integraattorillenne, joka tekee nämä muutokset. Muutosta ei voi tehdä ennen siirtoa. Tiedota integraattoriasi siis etukäteen ajankohdasta, jolloin muutos tulee tehtäväksi (Ajankohta on siirtohetki, josta olet saanut viestin).
Eli vain autentikaatiossa ja endpoint url tapahtuu muutoksia. Muutoin REST toimii ihan samoin. API-avain pysyy samana.
Huom, Rest rajapinnan timeout on kiinteästi 240 sekuntia.
Mistä tiedän, onko käytössä vielä SOAP-rajapinta?
Integraattorinne voi helposti tarkistaa tämän sanomatyypistä:
SOAP- xml sanoma muotoa
REST - Json sanoma muotoa
Jos ympäristönne on vielä vanhassa käyttäjähallinnassa, silloin on varmuudella vielä käytössä SOAP. Tällöin tulee siirtyä ensin uuteen käyttäjähallintaan. Voit luoda tästä tukipyynnön niin selvitellään millä aikataululla migraatio voidaan tehdä. Vasta uudessa käyttäjähallinnassa on REST käytössä.
Integraatiomme käyttää vielä SOAP-rajapintaa. Miten toimin?
SOAP-rajapinta ei ole enää tuettuna Azuressa, vaan rajapintatoteutus joudutaan tekemään uudestaan REST-rajapintaa vasten. Eli integraatio lakkaa toimimasta siirtohetkellä.
Integraattorin on tehtävä muutokset niin, että käytetään jatkossa REST-rajapintaa.
REST integraation toteutuksen aloitus
- Tunnukset, IWS_LOG lisenssi ja API-avain, joita käytetty SOAP:issa pysyvät samoina
- REST-osoite siirtymän jälkeen on rest.lemon.fi
- Organisaatiotunniste, joka löytyy Käyttäjähallinnasta kohdasta "Organisaatiotunniste".
- Rajapintakuvaukset löytyy https://rest.qa.test.lemonsoft.io/swagger/ui/index
- Tarkemman ohjeistuksen löydät tästä: https://lemondoc.atlassian.net/wiki/spaces/Rajapinnat/overview?homepageId=1217593573
- Testiympäristön voitte tilata meiltä tukipyynnöllä
- Voimme tarjota rajapintojen osalta konsultaatiota, jonka yrityksesi pääkäyttäjä voi tilata tukipyynnöllä
Olemme omalla palvelimella ja meillä on 3. osapuolen rajapinta. Koskeeko muutos meitä?
Jos käytössä on SOAP-rajapinta, päivitys REST-rajapintaan tulee tehdä mahdollisimman pian. SOAP lakkaa toimimasta tammikuun 2025 versiopäivityksessä.
Jos käytössä on REST-rajapinta, ei muutoksia tarvitse tehdä. Eli sekä REST-osoite että organisaatiotunniste on samat kuin tähänkin asti (nämä rest-osoitteen ja tunnisteen muutokset koskevat vain Lemonsoftin alustapalveluiden asiakkaita).
Verkkokaupan kolmannen osapuolen integraatio Lemonsoftiin on rakennettu SOAPilla. Nyt integraatio tulee muuttaa REST API-rajapinnaksi, voiko Lemonsoft auttaa tässä?
Jos verkkokokauppa-alustana toimii Woocommerce (Wordpressin verkkokauppa), verkkokaupan ja Lemonsoftin välinen integraatio voidaan toteuttaa LemonShop-lisäosalla. LemonShop-lisäosa verkkokaupassa on aina yhteensopiva Lemonsoftin toiminnanohjausjärjestelmän kanssa, ja tiedonsiirto tapahtuu kaksisuuntaisesti Lemonsoft-Woocommerce-Lemonsoft.
Jos verkkokauppa-alustana on jokin muu kuin Woocommerce, voidaan verkkokauppa rakentaa Woocommerceen, ja integrointi Lemonsoftiin onnistuu tällöin LemonShop-lisäosalla.