API (Application Programming Interface) on tekninen rajapinta, jonka avulla tietoja voidaan siirtää automaattisesti järjestelmästä toiseen. Käytännössä se tarkoittaa, että Linearista julkaistut kohteet ja niiden julkisia tietoja voidaan hyödyntää missä tahansa digitaalisessa kanavassa ilman, että tietoja tarvitsee syöttää useaan paikkaan manuaalisesti.
API-integraatio on paras vaihtoehto silloin, kun halutaan rakentaa täysin räätälöity ratkaisu kohdetietojen hyödyntämiseen. Se tarjoaa vapautta ja joustavuutta, mutta vaatii myös enemmän teknistä toteutusta verrattuna valmiisiin lisäosiin.
API-integraation avulla voit esimerkiksi:
- Rakentaa räätälöidyn kohdesivun yrityksesi verkkosivuille.
- Näyttää kohteita TV-näytöillä toimiston ikkunasta.
- Viedä kohdetietoja ulkoisiin järjestelmiin, kuten eri markkinointityökaluihin tai -järjestelmiin.
Hyvä huomioida ennen API-integraation toteutusta
Vaikka API tarjoaa monipuoliset mahdollisuudet, sen hyödyntäminen vaatii usein enemmän kehitystyötä kuin valmiit lisäosat, kuten WordPress-plug-in. Integraation toteutus vaatii yleensä verkkosivujen tai järjestelmäintegraatioiden parissa työskentelevän kehittäjän panosta.
Ennen projektin aloittamista kannattaa aina keskustella toteuttavan kehittäjän kanssa:
- kuinka laaja integraatio tarvitaan
- millaisia kustannuksia kehitystyöstä voi syntyä
- kuinka jatkossa ylläpidetään yhteys Linearin rajapintaan
API:n dokumentaatio
Tarkemman kohdetietojen ("listings") API-dokumentaation löytää Swaggerista:
https://linear-external-api.azurewebsites.net/api#/Listings/ExternalListingsController_externalListingsApi
Suositellut rajapinnat kotisivuintegraatioihin:
- v2/listings/performance – käytä tätä kerran yössä hakeaksesi kaikki Linearissa julkaistut kohteet konsernitasolla.
- v2/listings/update – käytä tätä jatkuvaan päivitykseen (esim. 5 minuutin välein). Tämä rajapinta palauttaa vain päivitetyt ja poistetut kohteet, mikä tekee tietojen synkronoinnista tehokasta ja kevyttä.
Lisätietoja välitysliikkeen API-avaimesta ja hinnoittelusta saa Linearin asiakastuesta.
API:n testaaminen
API-yhteyttä voisi testata myös Linearin testidatalla. Dokumentaatio löytyy Swaggerista:
https://external-api.lineartestlab.com/api#/
Testirajapinnan osoite on:
https://external-api.lineartestlab.com/v2/
API-avain testaukseen:
LINEAR-API-KEY b6b23692-e3fa-4525-9709-e021c8a65baa (Huom. sisällytä myös alku: "LINEAR-API-KEY")