Dypkoblinger til Kvipp

Integrasjoner kan åpne Kvipp i brukerens nettleser med person, utstyrstype og/eller konkret utstyr allerede lastet inn. Brukeren kommer til vanlig Kvipp-forside og kan fortsette med opplæring, kompetansesjekk eller skanning.

Grunn-URL-er

Miljø	URL
Produksjon	https://kvipp.it
Staging / test	https://test.kvipp.io

I eksemplene under står {base} for riktig vert.

Oversikt

Det du har	Dypkobling
Registry-UUID for person	/person/{uuid}
Registry-UUID for utstyrstype	/asset_type/{uuid}
Registry-UUID for utstyr	/asset/{uuid}
Flere Registry-UUID-er samtidig	/open?person_id=&asset_type_id=&asset_id=
Deres ID lagret som ekstern identifikator i Registry	/identifier/{identity}?source={source}
Kvipp 8-tegns ID	/id/{id}
Kun merke og modell (ingen UUID ennå)	/create_asset_type?brand=&model=

Når lenken åpnes, viser Kvipp en kort lasteskjerm, henter data fra Registry, lagrer valget i brukerens sesjon og sender brukeren til forsiden. Finnes ikke ID-en, får brukeren en tydelig «fant ikke»-side.

---

Registry-UUID-lenker (anbefalt)

Bruk disse når integrasjonen allerede bruker Registry API og dere har stabile id-verdier for personer, utstyrstyper eller utstyr.

Enkeltobjekt

Person

{base}/person/5574043f-4fc1-48d2-82a6-7dcf73418390

Utstyrstype (merke/modell-kategori i Registry)

{base}/asset_type/6dd19106-3708-4fea-becc-45ae3c001a4f

Utstyr (instans med serienummer; Kvipp laster også tilhørende utstyrstype)

{base}/asset/22934840-6214-4b84-bfde-7b239c6d2e33

UUID-ene må være gyldige Registry-ID-er. Ukjente eller ugyldige ID-er gir «fant ikke»-siden.

Kombinert lenke (/open)

Når dere vil ha både person og utstyrstype klare til opplæring (typisk for «start opplæring»-knapper i LMS eller portal):

{base}/open?person_id=5574043f-4fc1-48d2-82a6-7dcf73418390&asset_type_id=6dd19106-3708-4fea-becc-45ae3c001a4f

Query-parametre:

Parameter	Påkrevd	Beskrivelse
person_id	Nei*	Registry person-UUID
asset_type_id	Nei*	Registry utstyrstype-UUID
asset_id	Nei*	Registry utstyr-UUID
reset	Nei	true tømmer eksisterende person/utstyr-valg i nettleserens sesjon før lenken brukes
source	Nei	Integrator-slug for bruksmåling (se Source-parameter)

* Minst én av person_id, asset_type_id eller asset_id må være satt.

Sendes både asset_id og asset_type_id, bestemmes utstyrstypen av utstyrsrecorden.

---

Ekstern identifikator

Bruk dette når integrasjonen lagrer egne ID-er i stedet for Registry-UUID-er. Registrer først koblingen i Registry som ekstern identifikator (source + identity → person, utstyrstype eller utstyr). Åpne deretter Kvipp med:

{base}/identifier/{deres_id}?source={deres_kildenavn}

Eksempel — følg identifikator-eksemplet: person xy123 i system xyz koblet i Registry:

https://kvipp.it/identifier/xy123?source=xyz

Et annet eksempel — ERP-person emp-8842 med source=acme_hr:

https://kvipp.it/identifier/emp-8842?source=acme_hr

source må samsvare med det dere brukte da identifikatoren ble opprettet i Registry (Kvipp normaliserer til små bokstaver før oppslag). Kvipp slår opp identifikatoren og forhåndsutfyller person, utstyrstype eller utstyr avhengig av koblingen.

Har dere allerede Registry-UUID-er fra API-synk, er Registry-UUID-lenker enklere og hopper over identifikator-oppslag. Identifikatorer passer bedre når UUID-er kan endres (f.eks. ved sammenslåing) eller når produktet kun kjenner egne ID-er.

Se Eksterne identifikatorer for Registry-delen av flyten.

---

Kvipp kort-ID (/id/…)

For Kvipps egne 8-tegns identifikatorer (f.eks. på Kvipp ID QR-koder):

{base}/id/abc12345

Tilsvarende QR-URL: https://kvipp.it/id/abc12345.

Dette erstatter tidligere person/utstyr-valg i sesjonen med resultatet av oppslaget.

---

Source-parameter (bruksmåling)

Legg til en valgfri source query-parameter for å angi hvilket system som bygde lenken. Kvipp normaliserer alltid source til små bokstaver når lenken åpnes.

Rute	source
/person/{uuid}	Valgfri
/asset_type/{uuid}	Valgfri
/asset/{uuid}	Valgfri
/open?…	Valgfri
/create_asset_type?…	Valgfri
/identifier/{identity}?…	Påkrevd (Registry-identifikator-kilde; brukes også til analyse)

Bruk en stabil slug for produktet eller integrasjonen, for eksempel stemplet, equipment_page, eller deres registrerte identifikator-kilde (acme_hr). Parameteren endrer ikke hvordan lenken løses — den brukes til bruksmåling (unntatt på /identifier/…, der den er påkrevd for Registry-oppslag).

Eksempler:

{base}/person/5574043f-4fc1-48d2-82a6-7dcf73418390?source=stemplet

{base}/open?person_id=5574043f-4fc1-48d2-82a6-7dcf73418390&asset_type_id=6dd19106-3708-4fea-becc-45ae3c001a4f&source=equipment_page

Vi anbefaler små bokstaver i lenkene; blanding (f.eks. source=Stemplet) aksepteres og lagres som stemplet.

---

Merke- og modell-lenke

Utfasing (fra Q4 2026): Endepunktet /create_asset_type vil kreve spesiell autentisering fra fjerde kvartal 2026. Integrasjoner som bruker merke/modell-lenker bør migrere til Registry-UUID-lenker (/asset_type/{uuid}) der det er mulig. Kontakt support@digiquip.no for detaljer om autentisering før fristen.

Når dere ikke har Registry-UUID ennå, men kjenner produsent og modell (f.eks. fra typeskilt eller produktkatalog):

{base}/create_asset_type?brand=Genie&model=S60X&source=equipment_page

URL-kod spesialtegn i brand og model. Kvipp finner eller oppretter utstyrstypen i Registry og velger den i sesjonen.

Foretrekk Registry-UUID-lenker når dere allerede synkroniserer med Registry — da unngår dere duplikate utstyrstyper pga. stavevarianter.

---

Feilhåndtering

Resultat	Brukeren ser
Suksess	Kvipp-forside (/) med forhåndsutfylt sesjon
Ukjent ID, ugyldig UUID eller Registry-treff mangler	«Fant ikke»-side (/somethings_off?topic=not_found)

Test mot staging (test.kvipp.io + test-registry.kvipp.io) før produksjon.

Relatert

• Eksterne identifikatorer — koble deres ID-er til Registry
• Utstyrstyper og utstyr — datamodell i Registry
• Grunnleggende om Registry — API-adresser og autentisering

Spørsmål: support@digiquip.no