Gå til hovedinnhold

Kobo Bolig API Introduksjon

Kobolab​

Kobolab er en test- og demoløsning som i prinsippet er lik løsningene som er i produksjon, men bruker bare fiktive testdata. Alle data du legger inn slettes natt til mandag hver uke. "Her kan du prøve Kobo".

Sikkerhet​

For hvordan Kobo Bolig API konsumeres på en sikker måte kan man lese nærmere under Kobo Bolig API Maskinporten og på Kobo Bolig Webhook API.

Helt overordnet er det slik at alle kall skal gjøres på SSL. Kall til Kobo skal gjøres med Token utstedt av Maskinporten, og kall fra Kobo til leverandøren skal gjøres over SSL med hemmelighet overlevert Maskinporten autentisert og autorisert til Kobo.

API'er​

Kobo Bolig API-integrasjonen tilbyr to API tjenester.

  • Bolig API, for uthenting og oppdatering av informasjon om boliger og leieforhold
  • Webhook API for mottak av referanser til boliger som er oppdatert i Kobo

Kobo funksjonalitet​

Kobo er en digital tjeneste som vil lette prosessen med å søke, tildele og administrere kommunale utleieboliger, følge opp beboerne og skaffe datagrunnlag.

Tjenesten inneholder to digitale produkter.

Kobo-fagsystem​

  • Saksbehandling
  • Boligoversikt
  • Kunnskapsfane

Kobo-selvbetjening​

  • Søke om komunalbolig
  • Følge saken din
  • Sende og motta meldinger med di saksbehandler

Saksbehandling av søknad fra innbygger​

Følgende viser en overordnet flyt når en innbygger søker bolig. Flyten viser da kommunikasjonen mellom aktørene, inklusive kommunens FDVU-system.

Registrering av boliger i Kobo​

Boliger kan registreres på tre ulike måter i Kobo.

Manuell registrering​

Boligforvalter logger seg på Kobo Fagsystem og benytter funksjonalitet for å registrere en ny bolig.

Batch registrering​

Boligforvalter logger seg på Kobo Fagsystem og og bruker boligimporten for å laste opp CSV fil med informasjon om boligene. Boligimporten er en engangsjobb som typisk kjøres når man innførrer Kobo i kommunen.

Registrering gjennom maskin-til-maskin API​

Dette er ved bruk av API'et beskrevet i denne dokumentasjonen. Kobo Bolig API er et generisk api, men for begrepsbruk i kontraktene benyttes ofte navngivning for "FDVU*". Dette fordi det ligger en antakelse i bunn om at den vanligste integrasjonen mellom Kobo og eksterne løsninger på vegne av kommunen vil være et FDVU system.

Dokumentasjonen og api spesifikasjonsfilene omtaler ofte leverandørens system som FDVU-system.

Når boligforvalter oppretter en ny bolig i FDVU-systemet må de kunne merke boligen som en kommunal bolig slik at den blir sendt til Kobo. Hver melding kan kun inneholde en bolig.