Opprette prosjekter
Du kan opprette prosjekter fra ditt eget system, for eksempel når en arbeidsordre eller en befaring opprettes der, slik at arbeidet kan starte i Wenn Property før noen har vært på stedet.
Et prosjekt plasseres med adresse-ID-en: ID-en til en registrert vegadresse, som du bygger fra nøklene ethvert adressesøk mot Kartverket returnerer. Fritekstadresser godtas ikke, og vi tilbyr ikke adressesøk.
Tilgang
Section titled “Tilgang”Begge endepunktene krever scope write:projects. Det er separat fra read:projects. Svaret inneholder prosjektet du opprettet eller endret, så write:projects alene er nok til å lese disse prosjektene fra disse endepunktene.
Authorization: Bearer <ditt-token>Endepunkter
Section titled “Endepunkter”Opprett prosjekt
Section titled “Opprett prosjekt”POST /v1/projectsRequest body (valgfri):
| Felt | Type | Beskrivelse |
|---|---|---|
addressId | string | Valgfri. Adresse-ID-en til en registrert vegadresse. Uten den opprettes prosjektet uten adresse |
unitNumber | string | Valgfri. Leilighetens bruksenhetsnummer, f.eks. H0203. Bare sammen med addressId |
Eksempel:
POST /v1/projectsContent-Type: application/json
{ "addressId": "0301146220004000A000", "unitNumber": "H0203"}Returnerer 201 Created med prosjektet i samme form som GET /v1/projects/{projectId}. Adressen slås opp hos oss, så street, postalCode og city er fylt ut (se Adresse for feltene):
{ "id": "6720f0c2a1b2c3d4e5f60718", "createdAt": "2026-10-29T09:12:44Z", "createdBy": "gripr", "lastUpdated": "2026-10-29T09:12:44Z", "type": null, "address": { "street": "Maridalsveien 4A", "postalCode": "0178", "city": "OSLO", "unitNumber": "H0203" }, "coverPhoto": null, "photos": [], "rooms": [], "outsideAreas": [], "aiSummary": null, "inspectionNotes": null, "archived": false}Hvis adresse-ID-en ikke gir treff på en registrert vegadresse, feiler forespørselen med 422 address_not_found, og ingen prosjekter opprettes. Feilen inneholder ingen forslag.
Flere prosjekter kan ha samme adresse. Det er vanlig, for eksempel egne prosjekter for bad, fasade og garasje, så det er ikke en feil å opprette et prosjekt på en adresse som allerede har et.
createdBy er brukerens ID når en bruker oppretter prosjektet, og API-klientens navn (slik det ble oppgitt da klienten ble opprettet) når en backend-integrasjon oppretter det. Det lagres med små bokstaver, så en klient som heter Gripr, vises som gripr. Et navn med tegn utenfor Latin-1 (som –) brukes ikke; da lagres tokenets sub i stedet, som for en backend-integrasjon er <client_id>@clients, også med små bokstaver.
Sett prosjektadresse
Section titled “Sett prosjektadresse”PUT /v1/projects/{projectId}/addressSetter adressen på et prosjekt, for eksempel ett som ble opprettet uten adresse, eller erstatter adressen det har. Tak- og veggdata utledes fra adressen, så når adressen erstattes, erstattes de også.
Request body:
| Felt | Type | Beskrivelse |
|---|---|---|
addressId | string | Påkrevd. Adresse-ID-en til en registrert vegadresse |
unitNumber | string | null | Valgfri. Leilighetens bruksenhetsnummer, f.eks. H0203, som lagres sammen med adressen i samme endring. null fjerner det. Utelatt beholder prosjektet bruksenhetsnummeret når samme adresse settes på nytt, og mister det når adressen er en annen |
Eksempel:
PUT /v1/projects/6720f0c2a1b2c3d4e5f60718/addressContent-Type: application/json
{ "addressId": "11030365500010000000"}Returnerer 200 OK med det oppdaterte prosjektet, i samme form som GET /v1/projects/{projectId}. Hvis adresse-ID-en ikke gir treff, feiler forespørselen med 422 address_not_found, og prosjektet er uendret.
Bruksenhetsnummeret
Section titled “Bruksenhetsnummeret”Bruksenhetsnummeret er leilighetens nummer i det offisielle registeret, for eksempel H0203, og lar deg skille prosjekter på samme adresse fra hverandre. Det er én bokstav og fire sifre:
| Del | Betydning |
|---|---|
| Bokstav | Etasjetype: H hovedetasje, K kjeller, U underetasje, L loft |
| De to første sifrene | Etasjen |
| De to siste sifrene | Enheten i etasjen |
Små bokstaver godtas og lagres som store. Bare formatet kontrolleres, ikke om adressen har det bruksenhetsnummeret registrert. Eneboliger har som regel ikke bruksenhetsnummer; utelat da feltet.
Adresse-ID-en
Section titled “Adresse-ID-en”Adresse-ID-en er 20 tegn, bygget fra fem deler av en vegadresse i det offisielle adresseregisteret:
| Del | Lengde | Regel |
|---|---|---|
kommunenummer | 4 | Som det er, f.eks. 0301 |
adressekode | 5 | Fylt ut med nuller foran |
nummer (husnummer) | 4 | Fylt ut med nuller foran |
bokstav (husbokstav) | 4 | Den store bokstaven fylt ut med nuller foran (000A), eller 0000 når det ikke er bokstav |
undernummer | 3 | Alltid 000 for vegadresser |
Hente nøklene fra Kartverket
Section titled “Hente nøklene fra Kartverket”Ethvert adressesøk mot Kartverkets åpne adresse-API returnerer nøklene du trenger. For eksempel:
GET https://ws.geonorge.no/adresser/v1/sok?sok=Maridalsveien%204A&kommunenummer=0301Hvert treff i adresser har kommunenummer, adressekode, nummer og bokstav (tom streng når det ikke er bokstav). Integrasjoner som allerede bruker et adressesøk bygget på det offisielle adresseregisteret, har som regel de samme nøklene.
Bygge ID-en
Section titled “Bygge ID-en”function addressId(address: { kommunenummer: string; adressekode: number; nummer: number; bokstav: string;}): string { return ( address.kommunenummer + String(address.adressekode).padStart(5, "0") + String(address.nummer).padStart(4, "0") + address.bokstav.toUpperCase().padStart(4, "0") + "000" );}Eksempler
Section titled “Eksempler”| Adresse | kommunenummer | adressekode | nummer | bokstav | Adresse-ID |
|---|---|---|---|---|---|
| Krysantemumhagen 1, Stavanger | 1103 | 3655 | 1 | – | 11030365500010000000 |
| Maridalsveien 4A, Oslo (bygning med seks enheter) | 0301 | 14622 | 4 | A | 0301146220004000A000 |
| Gamle Maridalsvei 100, Oslo | 0301 | 12167 | 100 | – | 03011216701000000000 |
Alle enhetene i en bygning deler adresse-ID-en til bygningens adresse.
Bare vegadresser
Section titled “Bare vegadresser”Bare registrerte vegadresser støttes. Matrikkeladresser — eiendommer med bare gårdsnummer og bruksnummer og ingen gate — støttes ikke. ID-ene deres kan ha samme form som en vegadresse-ID, så de avvises av oppslaget med 422 address_not_found, ikke av formkontrollen.
Feilsvar
Section titled “Feilsvar”| Status | Kode | Når |
|---|---|---|
| 400 | invalid_request | Body er ugyldig: en feilformet adresse-ID (feil lengde, en bokstav utenfor husbokstavplassen, liten bokstav), et feilformet bruksenhetsnummer, unitNumber uten addressId på POST, manglende addressId på PUT, eller et felt endepunktet ikke tar imot |
| 403 | forbidden | Tokenet mangler write:projects-scope |
| 404 | project_not_found | Prosjektet finnes ikke (bare PUT) |
| 409 | address_conflict | Noen andre endret prosjektets adresse mens den ble satt (bare PUT). Prøv forespørselen på nytt |
| 422 | address_not_found | Adresse-ID-en er ikke en registrert vegadresse. Ingen prosjekter opprettes, og et eksisterende prosjekt er uendret |