Denne guiden er for agenter og egne integrasjoner som kaller Utins HTTP-API direkte. Du oppretter en personlig tilgangsnøkkel og lagrer den i agentens sikre nøkkellager.
Vil du ha det enkleste oppsettet? For de fleste agenter er Utins MCP-server det enkleste valget. Da logger du inn i nettleseren og slipper å opprette eller kopiere en API-nøkkel. Fortsett her hvis agenten eller integrasjonen trenger direkte tilgang til API-endepunktene.
Dette får du
Du får en autentisert API-klient som kan vise virksomhetene, arbeidsflatene og kontoene som er tilgjengelige.
Før du starter
Du trenger en Utin-konto og en agent eller integrasjon som kan lagre en API-nøkkel sikkert utenfor selve samtalen.
1. Koble kontoene til Utin
Åpne Legg til tilkoblinger, og koble til kontoene du vil bruke. Start innloggingen fra Utin, og fullfør den hos leverandøren.
2. Begrens tilgangen
En Utin-nøkkel har samme tilgang som personen som oppretter den. Bruk derfor et teammedlem med rettigheter som passer oppgavene agenten skal gjøre. Rapportering krever for eksempel ikke tilgang til publisering eller meldinger.
3. Opprett nøkkelen
Åpne Konto → Vis profil → Personlige tilgangsnøkler, og velg Opprett nøkkel.
Legg nøkkelen inn i agentens sikre nøkkellager. Ikke lim den inn i en vanlig chat, e-post eller et delt dokument. Du kan når som helst trekke nøkkelen tilbake i Utin.
Send nøkkelen som en autorisasjonsheader i direkte API-kall:
Authorization: Bearer <personlig tilgangsnøkkel>
Den gjeldende API-beskrivelsen finnes på https://app.utin.no/openapi, med en interaktiv utforsker på https://app.utin.no/openapi/ui.
4. Vis hva agenten har tilgang til
Be agenten eller integrasjonen vise virksomhetene, arbeidsflatene og de tilknyttede kontoene som er tilgjengelige for eieren av nøkkelen.
Instruksjon du kan kopiere
Vis virksomhetene, arbeidsflatene og de tilknyttede kontoene som er tilgjengelige for deg i Utin.
5. Velg hvor agenten skal jobbe
Velg en virksomhet og arbeidsflate fra listen, og bruk arbeidsflaten i neste forespørsel. Hvis noe mangler, kontrollerer du kontoen under Legg til tilkoblinger i Utin.
Greit å vite
Nøkkelen gir bare tilgang til det eieren allerede kan se og gjøre i Utin. Sosiale kontoer og annonsekontoer kobles til og oppdateres i Utin.
Hvis noe ikke virker
- Ingen tilgang: Kontroller at forespørselen bruker hele nøkkelen med prefikset
Bearer. Opprett en ny nøkkel hvis den gamle er trukket tilbake eller har kommet på avveie. - En arbeidsflate mangler: Kontroller at eieren av nøkkelen har tilgang til den i Utin.
- En konto mangler: Kontroller statusen under Legg til tilkoblinger, og be deretter om listen på nytt.
Les videre
Utviklere finner støttede handlinger og plattformdetaljer i API-guiden for Utin. Fortsett med publisering med en agent for en praktisk arbeidsflyt.
Vil du gjøre dette selv i appen? Les Koble til en KI-assistent via MCP.