Sivujamme selatessasi olet varmaan huomannut käsitteen API. Tämä lyhenne liittyy läheisesti IT-alaan, eikä lukijalle ole välttämättä heti selvää, mihin API:a käytetään ja mitä etuja sillä on. Siksi laadimme kolmiosaisen API:a koskevan sarjan sen toiminnasta ja siitä, miten se voi helpottaa EasyCargon käyttöä. Ensimmäinen osa on vähän teoreettinen – selitämme lyhenteen API merkityksen ja näytämme yksinkertaisessa esimerkissä, miten se toimii käytännössä. Tämän minisarjan muiden osien sisältö on esitetty artikkelin lopussa.

 

API:n rooli

Lähde: https://bykowski.pl/wp-content/uploads/2021/06/api-przyklad-dzialania-1.jpg

 

Edellä olevassa kuvassa on API:n rooli esitetty hyvin yksinkertaisesti. On kuitenkin hyvä selvittää ensin kysymys: Mikä API oikeastaan on? API on lyhenne sanoista Application Programming Interface, suomeksi ohjelmointirajapinta. On olemassa erilaisia API-rajapintoja, EasyCargon käytössä on ns. REST API. Tämän tyypin merkitystä emme tässä käsittele tarkemmin, sillä se ei ole kovin tärkeää API:n periaatteen ymmärtämiselle. Ohjelmointirajapinta on sarja ratkaisuja, joiden avulla voidaan käyttää muusta palvelusta saatavaa dataa omassa sivustossa tai ohjelmistossa. Mitä tämä tarkoittaa? Jos yrityksesi käytössä on sisäinen sovellus (esim. kuljetusten suunnitteluun), voit yksinkertaisesti ladata EasyCargo-tililtäsi dataa, joka toimitetaan suoraan yritysohjelmistoon.

 

API-avain EasyCargo-kontin täyttöohjelmistossa

EasyCargon tai muun ohjelmiston kanssa kommunikointiin API:n kautta tarvitaan kuitenkin API-avain. Se mahdollistaa sivustonne tunnistuksen kommunikoinnissa EasyCargon kanssa. Sen saamiseksi joko kirjoita meille osoitteeseen support@easycargo3d.com tai käytä yhteydenottolomaketta. Heti avaimen generoinnin jälkeen löydät sen käyttäjäprofiilisi oikeasta yläkulmasta.

Huom. – käsittele avainta kuin tilisi salasanaa, älä kerro sitä kenellekään!

Kaikki tärkeä on nyt selitetty ja lopuksi voimme vielä esittää yksinkertaisen esimerkin avulla, miten ohjelmointirajapinta käytännössä toimii.

 

Kuinka API toimii

Nyt sinulla pitäisi olla käsitys siitä, mitä API tarkoittaa ja miten se toimii. Katso myös API-infoa ja esimerkkejä EasyCargo API:n dokumentaatiota. Mutta ota huomioon, että kaikki dokumentaatiossa esitetyt esimerkit on kirjoitettu HTTP-protokollan avulla. Suosittelemme kuitenkin turvallisemman HTTPS-protokollan käyttöä.

 

API documentation in EasyCargo truck loading software

Ja nyt vain yhteenvetona, että API:a koskevan sarjan ensimmäinen osa on käyty läpi. Seuraava osa on käytännöllisempi. Tutustutamme sinut API:n käyttöön EasyCargon kanssa muun muassa API-asiakasohjelmamme avulla. Viimeisessä osassa selitämme, mitä kaikkea API:n ja EasyCargon välinen kommunikaatio mahdollistaa.

Bartosz Ziółkowski | 21. maalis 2022