Info: To see this page in english, click here.
Landax API er et grensesnitt som åpner for at andre systemer kan aksessere data fra Landax. Eksempler på bruksområder er:
- Egendefinerte skjema for rapportering av data (eks. Avvik)
- Påloggingsintegrasjon
- Synkronisering av data fra kunder, brukere osv.
Når man kommuniserer med APIet, har man full kontroll over hvilke data du aksesserer i kildesystemet og målsystemet. Ved å skrive og vedlikeholde synkroniseringsprogrammet, sikrer du at ingen data går tapt.
Tilkobling
For å koble på APIet trenger man en Landax-instans med en URL som vanligvis er på formatet «*.landax.no», for eksempel https://company.landax.no/. APIet finner du på /api/v{$version}, for eksempel https://company.landax.no/api/v20/. I skrivende stund er siste låste versjon 20. For å finne siste låste versjon, gå til /api/latest fra nettleseren. Der står det i toppen hva siste låste versjon er. Ikke bruk /api/latest til integrasjon! Det er mulig, men latest endrer seg hele tiden, og integrasjoner dit vil ikke fungere over tid.
For å se en oversikt over APIets datamodeller og funksjoner, besøk APIets adresse fra en nettleser.
Versjonering
Alle versjoner utenom siste versjon (latest) er låst for endringer. Kontakt oss dersom du ønsker å bruke funksjonalitet som ikke finnes i nyeste versjon av API. Vi anbefaler alltid å bruke siste låste versjon av API. Enhver tid gjeldende status for
versjoner finnes ved å besøke APIet i en nettleser. Siste ulåste verson (latest) skal ikke brukes til integrasjon.
Protokoller
APIet har to protokoller. Det ene ligger på /api/v24 som er definert av en OpenAPI spesifikasjon. Denne finner du på /api/v25/openapi.json eller /api/v25/openapi.yaml. APIet følger ganske generelle praksiser som er inspirert av OData-standarden, men avviker også fra denne på flere områder.
APIet støtter også OData protokollen, og den finnes på /odata/v25. OData metadata ligger på /odata/v25/$metadata, men de fleste OData-klienter vil være fornøyd om du peker på /odata/v25. Denne er nyttig for PowerBI integrasjoner og andre klienter som er skreddersydd for OData.