VARDLY on VARDLY | FDV-system for bygg

Autentisering

Fri, 31 Jul 2026 00:00:00 +0200

Alle API-ene er beskyttet. Hver forespørsel må ha et gyldig token fra Sirkteks innloggingstjeneste, og forespørsler som gjelder én organisasjons data må i tillegg si hvilken organisasjon det er.

De to headerne

Header	Verdi	Når
`Authorization`	`Bearer <jwt>`	Alltid
`X-auth-owner`	organisasjons-ID	På alle organisasjonsavgrensede endepunkt

Innloggingstjenesten er https://auth2.sirktek.com. Endepunktene finner du i OIDC-dokumentet:

 https://auth2.sirktek.com/.well-known/openid-configuration

Maskin-til-maskin: API-nøkkel

Et system som kjører uten en innlogget bruker autentiserer seg med en API-nøkkel — en klient-ID og en klienthemmelighet du oppretter i Sirktek. Se API-nøkler.

Brukere og roller

Fri, 31 Jul 2026 00:00:00 +0200

Hva VARDLY trenger

VARDLY har ingen egen brukerdatabase. Alle som skal bruke systemet må være brukere i organisasjonen din hos Sirktek, og de logger inn med den samme brukeren.

Tilgangene VARDLY bruker:

Det brukeren skal gjøre	Trenger
Se eiendommer, kontrollpunkt og avvik	Lesetilgang til organisasjonens objekter
Gjennomføre en kontrollrunde og registrere resultater	Skrivetilgang til objekter og hendelser
Registrere og lukke avvik	Skrivetilgang til avvik
Laste opp FDV-dokumentasjon	Skrivetilgang til dokumenter
Opprette eiendommer og kontrollpunkt	Skrivetilgang til objekter

Hvorfor det er slik

Tilgangskontrollen ligger i backend, ikke i appen. VARDLY viser eller skjuler knapper etter rettighetene i innloggingen din, men det er tjenesten som avgjør — en bruker uten rettighet får avslag selv om knappen skulle dukke opp. Det betyr at rollene må være riktige i Sirktek for at VARDLY skal oppføre seg som forventet.

MCP-serveren

Fri, 31 Jul 2026 00:00:00 +0200

Ikke allment tilgjengelig ennå.

Sirktek MCP-server er under utrulling. Automatisk klientregistrering er ennå ikke på plass i innloggingstjenesten, så en MCP-klient må foreløpig settes opp med en forhåndsregistrert klient-ID. Ta kontakt med Sirktek for tilgang.

Endepunkt


Endepunkt	`https://mcp.sirktek.com/mcp`
Transport	Streamable HTTP
Innloggingstjeneste	`https://auth2.sirktek.com`

Innlogging

Serveren er en OAuth2-beskyttet ressurs. Hver forespørsel må ha et gyldig token fra Sirkteks innloggingstjeneste. Serveren kontrollerer utsteder, signatur, utløp og mottaker før noe verktøy kjøres, og sender så tokenet videre til API-ene uendret.

Opprette kontrollpunkt

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver hvordan et kontrollpunkt opprettes og knyttes til riktig eiendom.

Se Kontrollpunkt for oversikten over hva denne delen dekker.

Planlegge en runde

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver planlegging av en runde, inkludert valg av rundetype og kontrollpunkt.

Se Kontrollrunder for oversikten over hva denne delen dekker.

Registrere en eiendom

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver hvordan du oppretter en eiendom og hvilke opplysninger som trengs.

Se Eiendommer for oversikten over hva denne delen dekker.

Registrere et avvik

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver registrering av avvik, med beskrivelse, frist og ansvarlig.

Se Avvik for oversikten over hva denne delen dekker.

FDV-dokumentasjon

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver hvordan tegninger, datablad og rapporter legges på eiendommen.

Se Eiendommer for oversikten over hva denne delen dekker.

Feilhåndtering

Fri, 31 Jul 2026 00:00:00 +0200

Feilmeldingen står i svaret

Tjenestene returnerer en lesbar melding — både i svarkroppen og i headeren error-message. Det er den meldingen som skal vises til brukeren, oversatt om nødvendig. Ikke vis en rå HTTP-statuskode; den sier ingenting om hva som faktisk gikk galt.

 HTTP/1.1 403 Forbidden
error-message: Bruker har ikke tilgang til denne organisasjonen

401 og 403 er to forskjellige problemer

Status	Betyr	Sjekk
401 Unauthorized	Tokenet mangler, er utløpt, eller er ikke gyldig	Sendes `Authorization: Bearer …`? Er tokenet utløpt? Er det utstedt av `auth2.sirktek.com`? Stemmer `audience`?
403 Forbidden	Tokenet er gyldig, men gir ikke tilgang til dette	Mangler `X-auth-owner`, peker den på feil organisasjon, eller mangler brukeren eller API-nøkkelen rettigheten?

Kort sagt: 401 er et tokenproblem, 403 er et rettighetsproblem. Å hente nytt token hjelper aldri mot en 403.

Følge opp avvik

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver oversikten over avvik, og hvordan frister og ansvar følges opp.

Se Avvik for oversikten over hva denne delen dekker.

Gjennomføre en runde

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver gjennomføring i felt, og hvordan et punkt registreres som i orden eller som avvik.

Se Kontrollrunder for oversikten over hva denne delen dekker.

Kategorier

Fri, 31 Jul 2026 00:00:00 +0200

Hva VARDLY trenger

VARDLY skiller ikke mellom objekttyper med et eget felt — det bruker kategorisystemet i Sirktek. To kategorier er avgjørende:

VARDLY-begrep	Kategori i Sirktek
Eiendom	Objektet kategoriseres som fast eiendom
Kontrollpunkt	Objektet kategoriseres som kontrollpunkt

Er et objekt ikke kategorisert, vet ikke VARDLY om det er et bygg eller et brannslukningsapparat, og det dukker ikke opp der du forventer.

Hvorfor det er slik

Kategoriene er felles for hele Sirktek-plattformen. Det er derfor det samme objektet — og den samme QR-koden — kan brukes av VARDLY og av Sirkteks øvrige løsninger uten dobbeltregistrering. Prisen er at kategoriseringen må være riktig fra starten.

Koble til en klient

Fri, 31 Jul 2026 00:00:00 +0200

Ikke allment tilgjengelig ennå.

Velg riktig innlogging

Situasjon	Innlogging	Organisasjon
Du sitter selv og snakker med assistenten	Din egen Sirktek-innlogging	Velges i samtalen hvis du hører til flere
En agent kjører automatisk, uten deg	API-nøkkel fra Sirktek	Bundet til én organisasjon, velges aldri

Er du i tvil: bruker du assistenten selv, skal den bruke din innlogging.

QR-merking

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver hvordan QR-koder bestilles og festes, og hvordan de henger sammen med kodene i resten av Sirktek.

Se Kontrollpunkt for oversikten over hva denne delen dekker.

Lokasjoner

Fri, 31 Jul 2026 00:00:00 +0200

Hva VARDLY trenger

Et kontrollpunkt hører til en eiendom fordi de deler lokasjon. Det er lokasjonsstrukturen i Sirktek som binder dem sammen — ikke en egen kobling i VARDLY.

Det betyr i praksis:

Hver eiendom må ha en lokasjon.
Kontrollpunktene på eiendommen må ha den samme lokasjonen.
Er lokasjonen feil, havner kontrollpunktet på feil bygg — eller ingen steder.

Hvorfor det er slik

Lokasjonsdimensjonen er felles for hele plattformen, på samme måte som kategoriene. Det gjør at et objekt kan flyttes mellom bygg uten å måtte registreres på nytt, og at VARDLY og Sirkteks øvrige løsninger ser den samme strukturen.

Lukke et avvik

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver lukking av et avvik og hva som registreres i revisjonssporet.

Se Avvik for oversikten over hva denne delen dekker.

Resultat og dokumentasjon

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver resultatvisningen for en gjennomført runde, og hva som kan dokumenteres ut av den.

Se Kontrollrunder for oversikten over hva denne delen dekker.

Skanne i felt

Fri, 31 Jul 2026 00:00:00 +0200

Denne siden er under arbeid.

Beskriver skanning på mobil, og hva som skjer når koden ikke lar seg lese.

Se Kontrollpunkt for oversikten over hva denne delen dekker.

Verktøy

Fri, 31 Jul 2026 00:00:00 +0200

Ikke allment tilgjengelig ennå.

En assistent koblet til Sirktek har fire verktøy tilgjengelig. Tre av dem leser; ett av dem skriver.

Verktøy	Hva det gjør	Skriver data
`asset_list`	Søker opp og lister objektene i organisasjonen — eiendommer, kontrollpunkt og annet utstyr	Nei
`asset_taxonomy`	Henter kategoristrukturen, slik at assistenten vet hvilke kategorier som finnes	Nei
`asset_organizations`	Lister organisasjonene innloggingen din gjelder for	Nei
`asset_create`	Oppretter et nytt objekt i organisasjonen	Ja

Om det som skriver

asset_create oppretter faktiske objekter i organisasjonen din. En god MCP-klient spør deg før den kjører et verktøy som endrer noe — la den gjøre det. Et objekt som opprettes ved en feil må ryddes opp manuelt i Sirktek.

API-nøkler

Fri, 31 Jul 2026 00:00:00 +0200

Når du trenger dette

Bare hvis noe skal jobbe med dataene dine uten en innlogget bruker:

et annet system som integrerer mot VARDLY-dataene
en AI-assistent som kjører automatisk, uten at noen sitter og godkjenner

Skal en person bruke VARDLY, eller en assistent jobbe på vegne av en innlogget person, trengs ingen API-nøkkel — da brukes personens egen innlogging.

Hva VARDLY trenger

En API-nøkkel er knyttet til én organisasjon. Det gjør oppsettet enkelt: en integrasjon med API-nøkkel trenger aldri å velge hvilken organisasjon den jobber i, slik en bruker med flere organisasjoner må.

VARDLY on VARDLY | FDV-system for bygg

Autentisering

De to headerne link

Maskin-til-maskin: API-nøkkel link

Brukere og roller

Hva VARDLY trenger link

Hvorfor det er slik link

MCP-serveren

Endepunkt link

Innlogging link

Opprette kontrollpunkt

Planlegge en runde

Registrere en eiendom

Registrere et avvik

FDV-dokumentasjon

Feilhåndtering

Feilmeldingen står i svaret link

401 og 403 er to forskjellige problemer link

Følge opp avvik

Gjennomføre en runde

Kategorier

Hva VARDLY trenger link

Hvorfor det er slik link

Koble til en klient

Velg riktig innlogging link

QR-merking

Lokasjoner

Hva VARDLY trenger link

Hvorfor det er slik link

Lukke et avvik

Resultat og dokumentasjon

Skanne i felt

Verktøy

Om det som skriver link

API-nøkler

Når du trenger dette link

Hva VARDLY trenger link

De to headerne

Maskin-til-maskin: API-nøkkel

Hva VARDLY trenger

Hvorfor det er slik

Endepunkt

Innlogging

Feilmeldingen står i svaret

401 og 403 er to forskjellige problemer

Hva VARDLY trenger

Hvorfor det er slik

Velg riktig innlogging

Hva VARDLY trenger

Hvorfor det er slik

Om det som skriver

Når du trenger dette

Hva VARDLY trenger