Reinventar on Reinventar | Markedsplassen for møbeltjenesterhttps://doc.reinventar.no/Recent content in Reinventar on Reinventar | Markedsplassen for møbeltjenesterHugonoMon, 31 Aug 2026 00:00:00 +0200Tjenestesøkhttps://doc.reinventar.no/docs/api/tjenester/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/api/tjenester/<p>Du har en kontorstol. Hvilke tjenester kan den få? Det svarer ett endepunkt på:</p> <div class="prism-codeblock "> <pre id="a0cc87e" class="language- "> <code>GET https://api.sirktek.com/orgadmin/v1/solutions?category=OfficeChair</code> </pre> </div> <p>Endepunktet er åpent. Det krever ingen innlogging.</p> <h2 id="søket-går-oppover">Søket går oppover <a href="#s%c3%b8ket-g%c3%a5r-oppover" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>Standardoppførselen er <code>categoryMatch=ancestors</code>. Da matcher søket kategorien selv og alle kategoriene over den i taksonomien:</p> <div class="prism-codeblock "> <pre id="23f9795" class="language- "> <code>Kontorstol → Stol → Sittemøbler → Møbler</code> </pre> </div> <p>En tjeneste registrert på <strong>Stol</strong> treffer altså søket etter <strong>Kontorstol</strong>. Det er poenget: leverandøren registrerer tjenesten én gang, på riktig nivå. Du finner den uansett hvor spesifikt objektet ditt er kategorisert.</p>Tilbud og ordrehttps://doc.reinventar.no/docs/api/tilbud-ordre/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/api/tilbud-ordre/<div class="ri-status-note" role="note"> <span class="material-icons" aria-hidden="true">schedule</span> <div> <strong>Ikke allment tilgjengelig ennå.</strong> <p>Ordre-API-et har ennå ingen publisert produksjonsadresse. Stiene i dokumentasjonen er stabile. Ta kontakt med Sirktek for tilgang til testmiljøet.</p> </div> </div> <p>Ordre-API-et fører en tjenesteordre fra første forespørsel til godkjent leveranse. API-et er bygget etter HATEOAS-prinsippet: <strong>hvert svar forteller deg hva du kan gjøre videre.</strong> Du trenger ikke hardkode flyten i klienten din.</p> <h2 id="hva-er-hateoas">Hva er HATEOAS? <a href="#hva-er-hateoas" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>HATEOAS står for <em>Hypermedia as the Engine of Application State</em>. Det er en del av REST-arkitekturen, beskrevet av Roy Fielding. Les mer på <a href="https://en.wikipedia.org/wiki/HATEOAS" rel="external" target="_blank">Wikipedia<svg width="16" height="16" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" d="M14 5c-.552 0-1-.448-1-1s.448-1 1-1h6c.552 0 1 .448 1 1v6c0 .552-.448 1-1 1s-1-.448-1-1v-3.586l-7.293 7.293c-.391.39-1.024.39-1.414 0-.391-.391-.391-1.024 0-1.414l7.293-7.293h-3.586zm-9 2c-.552 0-1 .448-1 1v11c0 .552.448 1 1 1h11c.552 0 1-.448 1-1v-4.563c0-.552.448-1 1-1s1 .448 1 1v4.563c0 1.657-1.343 3-3 3h-11c-1.657 0-3-1.343-3-3v-11c0-1.657 1.343-3 3-3h4.563c.552 0 1 .448 1 1s-.448 1-1 1h-4.563z"/></svg></a>.</p>Autentiseringhttps://doc.reinventar.no/docs/api/autentisering/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/api/autentisering/<p>De åpne endepunktene for taksonomi og tjenestesøk krever ingen innlogging. Alt annet er beskyttet. Hver forespørsel må ha et gyldig token fra Sirkteks innloggingstjeneste. Forespørsler som gjelder én organisasjons data må i tillegg si hvilken organisasjon det er.</p> <h2 id="de-to-headerne">De to headerne <a href="#de-to-headerne" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2> <table class="table table table-striped"> <thead> <tr> <th>Header</th> <th>Verdi</th> <th>Når</th> </tr> </thead> <tbody> <tr> <td><code>Authorization</code></td> <td><code>Bearer &lt;jwt&gt;</code></td> <td>På alle beskyttede endepunkt</td> </tr> <tr> <td><code>X-auth-owner</code></td> <td>organisasjons-ID</td> <td>På alle organisasjonsavgrensede endepunkt</td> </tr> </tbody> </table> <p>Innloggingstjenesten er <code>https://auth2.sirktek.com</code>. Endepunktene finner du i OIDC-dokumentet:</p> <div class="prism-codeblock "> <pre id="36e9bff" class="language- "> <code>https://auth2.sirktek.com/.well-known/openid-configuration</code> </pre> </div> <h2 id="maskin-til-maskin-api-nøkkel">Maskin-til-maskin: API-nøkkel <a href="#maskin-til-maskin-api-n%c3%b8kkel" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>Et system som kjører uten en innlogget bruker autentiserer seg med en API-nøkkel. Det er en klient-ID og en klienthemmelighet du oppretter i Sirktek-administrasjonen.</p>Identifikatorerhttps://doc.reinventar.no/docs/taksonomi/identifikatorer/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/taksonomi/identifikatorer/<p>En kategori har tre identiteter. Alle tre peker på det samme.</p> <table class="table table table-striped"> <thead> <tr> <th>Identitet</th> <th>Eksempel</th> <th>Bruk</th> </tr> </thead> <tbody> <tr> <td><strong>Klassenavn</strong></td> <td><code>OfficeChair</code></td> <td>Kortformen i API-kall. Engelsk, stabil.</td> </tr> <tr> <td><strong>URI</strong></td> <td><code>http://taxonomy.sirktek.no/furniture#OfficeChair</code></td> <td>Fullt navn. Entydig på tvers av taksonomier.</td> </tr> <tr> <td><strong>Numerisk ID</strong></td> <td><code>-907692052</code> (for <code>Chair</code>)</td> <td>Nøkkelen i data. Alltid negativ for felleskategorier.</td> </tr> </tbody> </table> <h2 id="klassenavn">Klassenavn <a href="#klassenavn" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>Klassenavnet er engelsk og skrives i PascalCase: <code>Chair</code>, <code>OfficeChair</code>, <code>CabinetUnit</code>. Det norske navnet, for eksempel «Kontorstol», er visningstekst. Bruk aldri visningsteksten som nøkkel.</p> <p>I API-kall kan du bruke klassenavnet direkte:</p>MCP-serverenhttps://doc.reinventar.no/docs/ai/mcp-server/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/ai/mcp-server/<div class="ri-status-note" role="note"> <span class="material-icons" aria-hidden="true">schedule</span> <div> <strong>Ikke allment tilgjengelig ennå.</strong> <p>Sirktek MCP-server er under utrulling. Tjeneste-verktøyene (søk etter tjenester og tilbud-ordre-flyt) legges til snart. Ta kontakt med Sirktek for tilgang.</p> </div> </div> <h2 id="endepunkt">Endepunkt <a href="#endepunkt" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2> <table class="table table table-striped"> <thead> <tr> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td><strong>Endepunkt</strong></td> <td><code>https://mcp.sirktek.com/reinventar</code></td> </tr> <tr> <td><strong>Transport</strong></td> <td>Streamable HTTP</td> </tr> <tr> <td><strong>Innloggingstjeneste</strong></td> <td><code>https://auth2.sirktek.com</code></td> </tr> </tbody> </table> <h2 id="innlogging">Innlogging <a href="#innlogging" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>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. Så sender den tokenet videre til API-ene uendret.</p>Feilhåndteringhttps://doc.reinventar.no/docs/api/feilhandtering/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/api/feilhandtering/<h2 id="feilmeldingen-står-i-svaret">Feilmeldingen står i svaret <a href="#feilmeldingen-st%c3%a5r-i-svaret" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>Tjenestene returnerer en <strong>lesbar melding</strong>, både i svarkroppen og i headeren <code>error-message</code>. Den er ment for visning til brukeren, oversatt om nødvendig.</p> <div class="prism-codeblock "> <pre id="3f71d76" class="language- "> <code>HTTP/1.1 403 Forbidden error-message: Bruker har ikke tilgang til denne organisasjonen</code> </pre> </div> <h2 id="401-og-403">401 og 403 <a href="#401-og-403" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>Det plattformspesifikke å sjekke:</p> <table class="table table table-striped"> <thead> <tr> <th>Status</th> <th>Sjekk her</th> </tr> </thead> <tbody> <tr> <td><strong>401 Unauthorized</strong></td> <td>Tokenet er utstedt av <code>auth2.sirktek.com</code>, <code>audience</code> stemmer, og det er ikke utløpt.</td> </tr> <tr> <td><strong>403 Forbidden</strong></td> <td><code>X-auth-owner</code> peker på riktig organisasjon, og brukeren eller API-nøkkelen har rettigheten.</td> </tr> </tbody> </table> <p>De åpne endepunktene godtar forespørsler uten token, men avviser et ugyldig eller utløpt token med 401.</p>Koble til en klienthttps://doc.reinventar.no/docs/ai/koble-til-klient/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/ai/koble-til-klient/<div class="ri-status-note" role="note"> <span class="material-icons" aria-hidden="true">schedule</span> <div> <strong>Ikke allment tilgjengelig ennå.</strong> <p>Sirktek MCP-server er under utrulling. Tjeneste-verktøyene (søk etter tjenester og tilbud-ordre-flyt) legges til snart. Ta kontakt med Sirktek for tilgang.</p> </div> </div> <h2 id="velg-riktig-innlogging">Velg riktig innlogging <a href="#velg-riktig-innlogging" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2> <table class="table table table-striped"> <thead> <tr> <th>Situasjon</th> <th>Innlogging</th> <th>Organisasjon</th> </tr> </thead> <tbody> <tr> <td>Du sitter selv og snakker med assistenten</td> <td>Din egen Sirktek-innlogging</td> <td>Velges i samtalen hvis du hører til flere</td> </tr> <tr> <td>En agent kjører automatisk, uten deg</td> <td>API-nøkkel fra Sirktek</td> <td>Bundet til én organisasjon, velges aldri</td> </tr> </tbody> </table> <p>Er du i tvil: bruker du assistenten selv, skal den bruke din innlogging.</p>Verktøyhttps://doc.reinventar.no/docs/ai/verktoy/Mon, 31 Aug 2026 00:00:00 +0200https://doc.reinventar.no/docs/ai/verktoy/<div class="ri-status-note" role="note"> <span class="material-icons" aria-hidden="true">schedule</span> <div> <strong>Ikke allment tilgjengelig ennå.</strong> <p>Sirktek MCP-server er under utrulling. Tjeneste-verktøyene (søk etter tjenester og tilbud-ordre-flyt) legges til snart. Ta kontakt med Sirktek for tilgang.</p> </div> </div> <p>En assistent koblet til Sirktek har fire verktøy tilgjengelig. Tre av dem leser; <strong>ett av dem skriver.</strong></p> <table class="table table table-striped"> <thead> <tr> <th>Verktøy</th> <th>Hva det gjør</th> <th>Skriver data</th> </tr> </thead> <tbody> <tr> <td><code>asset_list</code></td> <td>Søker opp og lister objektene i organisasjonen, for eksempel møblene dine</td> <td>Nei</td> </tr> <tr> <td><code>asset_taxonomy</code></td> <td>Henter kategoristrukturen, slik at assistenten vet hvilke kategorier som finnes</td> <td>Nei</td> </tr> <tr> <td><code>asset_organizations</code></td> <td>Lister organisasjonene innloggingen din gjelder for</td> <td>Nei</td> </tr> <tr> <td><code>asset_create</code></td> <td><strong>Oppretter et nytt objekt</strong> i organisasjonen</td> <td><strong>Ja</strong></td> </tr> </tbody> </table> <h2 id="om-det-som-skriver">Om det som skriver <a href="#om-det-som-skriver" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p><code>asset_create</code> 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.</p>