Tilgang til vårt API

Boligmappa API er en av grunnpilarene til Boligmappa. Det er gjennom API vi får brorparten av alt det innholdet som er skapt i Boligmappa. Det er gjennom API hvor vi når ut til titusenvis av kvalifiserte håndverkere og også millioner av privatpersoner.

Alt fra Visma til Digipost og våre egne løsninger. Alt er koblet gjennom APier.

Forum for utviklere

I vårt forum beskriver vi våre ulike APIer. 

https://devforum.boligmappa.no/hc/en-us

Greit å vite

For Boligmappa API 1.0 og API 2.0 kreves det brukernavn og passord. Det er ulike brukernavn og passord for testmiljø (staging) og produksjonsmiljø (prod).

Vårt testmiljø (Staging) går mot en kopi av en gammel grunnbok og er ikke like oppdatert som produksjon. Det er noen uker/måneder i forskjell. Et boligmappenummer i testmiljø er ikke det samme som boligmappenummer i prod-miljø. AAA0888 i testmiljø og AAA0888 i prod-miljø tilhører derfor forskjellige boliger.

Brukernavn og passord i API 1.0 og API 2.0 er noe som kalles Plain text. Brukernavn og passord sendes direkte for å få tilgang til våre tjenester. Det er en sikkerhetsrisiko. Selv om dette går via sikre linjer (https), så er det ikke å anbefale. 

Boligmappa Proff API, Boligeier API, FinnIT bruker annen form for autentisering og er således tryggere.

Hvordan få tilgang.

 API 1.0 og API 2.0

Opprett helt vanlige konto på testadmin.boligmappa.no (for testmiljø) og onboardingen for prod miljø. Fagområdet skal være elektriker, rørlegger, snekker og integrasjons-partner.

Testmiljø:

Tidligere har vi brukt dette som standard brukernavn for testmiljø: test. + de tre første og tre siste av organisasjonsnummeret. Brukernavn for Boligmappa i testmiljø vil derfor være: test.998650

Passord er normalt sett satt til "test1" - dette kan de selv velge å endre.

Prod-miljø:

Standard har vi satt brukernavn som : admin. + de tre første og tre siste av organisasjonsnummeret. Brukernavn for Boligmappa i testmiljø vil derfor være: admin.998650
Passord er normalt sett satt til "prod1". Dette kan de velge å endre selv.

For eiendomsmeglere, takst, el-tilsyn må vi gi beskjed til utviklerne om at brukernavnet skal ha tilgang til "auditor rights". Dette er da tilgang til tjenester i vårt API som trenger ytterligere godkjenning. Dette er i vårt API referert som "Special rights services"https://devforum.boligmappa.no/hc/en-us/sections/360001608713-Special-Services

Boligeier API, FinnIT, Boligmappa Proff o.l.

For tilgang må dere kontakte support i Sri Lanka for å få satt opp konto for henholdsvis testmiljø og prod-miljø. Spesifiser at det gjelder konto for Boligeier API, Proff og ikke API 1.0 eller API 2.0