Utviklerressurser og agentdiscovery

Bygg trygt mot Revly.

Her finner du Revlys offentlige, maskinlesbare ressurser. Start med OpenAPI-spesifikasjonen eller helsestatusen, og les autentiseringsprofilen før du ber om tilgang til beskyttede produktdata.

Offentlige ressurser

Én inngang for mennesker og maskiner.

Alle dokumentene under er offentlige og kan hentes uten brukerdata eller hemmeligheter.

01

OpenAPI 3.1

Se /openapi.json for den publiserte API-kontrakten, operasjons-ID-er, svarskjemaer og lenke til autentiseringsprofilen.

02

API-katalog

RFC 9727-linksettet på /.well-known/api-catalog peker til API-kontrakt, dokumentasjon og offentlig helsestatus.

03

Agentdiscovery

llms.txt, llms-full.txt, MCP server card, Agent Skills-index og auth.md forklarer når og hvordan Revly skal brukes.

04

Offentlig helse

GET /api/public/health returnerer kun tjenestestatus og kontrolltidspunkt. Det krever ikke autentisering.

Kom i gang

Tre steg til en ryddig integrasjon.

Begynn med dokumentene som kan leses uten credentials. Be om menneskelig godkjenning før du kobler deg til beskyttede produktdata.

  1. 01

    Les kontrakten

    Hent /openapi.json og /api-health.md. Bruk operationId og typed response schemas når du lager klienten.

  2. 02

    Forstå tilgang

    Les /auth.md og OAuth/OIDC-discovery under /.well-known. Ikke anta at anonym tilgang gir produktdata.

  3. 03

    Test uten kundedata

    Start med /api/public/health eller MCP-tjenestens åpne helsesjekk. Bruk syntetiske data og få en menneskelig bekreftelse før handlinger.

Eksterne assistenter

Koble Revly til en ekstern assistent via MCP.

Med Revlys tilkobling på https://revly.no/mcp (MCP) kan en ekstern assistent (ChatGPT, Claude, Grok, Codex eller Microsoft 365 Copilot) lese avgrenset oppdragsstatus i ett Revly-firma. Først slår en partner på lesetilgang under Firma → Abonnement. Registreringsnivåene er på som standard, og en partner kan slå dem av. Deretter kobler du selvbetjente verter (Claude, Grok) under Innstillinger → Sikkerhet; ChatGPT og Microsoft 365 Copilot setter Revly opp for firmaet (support@revly.no). Microsoft 365 Copilot er forberedt teknisk, men ikke åpnet for generell bruk ennå. I alle tilfeller logger personen inn i Revly og godkjenner tilkoblingen selv.

01

Hva assistenten kan lese

Firmaets navn og din rolle, oppdragsoversikt med lovfrister og svarfrister for hele porteføljen, avgrenset oppdragsstatus, forespørsler til klienten uten tekst, status for avslutningen uten tekst, revisjonshandlinger per område uten tekst, granskningsfunn med kode, merking og vurdering uten lang beskrivelse, vurderingskommentar uten e-post, registrert vesentlighet med begrunnelse (opptil 2 000 tegn) og signeringsstatus. Ikke dokumenter eller klientmeldinger. Nye leseverktøy innenfor samme samtykkenivå kan komme uten nytt samtykke.

02

Registrering av oppstartsfakta

Et eget nivå med eget samtykke. Det er på som standard, og en partner kan slå det av. Assistenten kan registrere daterte oppstartsfakta på et oppdrag, for eksempel at en forespørsel til tidligere revisor er sendt, og lese den samme historikken. Registreringer legges til og overskriver aldri det som finnes. Assistenten sender ingen meldinger, signerer ikke og godkjenner ingen faglige vurderinger.

03

Registrering av bemanning

Et eget nivå med eget samtykke, for revisorer og partnere. Det er på som standard, og en partner kan slå det av. Assistenten ser firmaets aktive personer med navn og e-post, og kan prøvekjøre og skrive team og ansvarlig partner fra en liste. Å sette ansvarlig partner og gi andre rollen revisor krever at du er partner. Den fjerner aldri noen og erstatter aldri en annen ansvarlig. Den sender ingen varsler, signerer ikke og godkjenner ikke uavhengighet.

04

Personlig samtykke

Du logger inn i Revly, velger ett firma og godkjenner tilkoblingen. Tilgangen krever at du fortsatt har en aktiv rolle i firmaet. Hva assistenten får, følger firmaet og nivåene du har godkjent, og noen nivåer krever en bestemt rolle.

05

Tilbakekalling

Trekk tilgangen tilbake under Innstillinger, Sikkerhet, Tilgang fra eksterne assistenter. Å fjerne appen i assistenten (ChatGPT, Claude, Grok, Copilot m.fl.) trekker ikke tilbake tilgangen i Revly.

06

Sporbarhet

Revly lagrer hver oppdragslesing som sporbar historikk på oppdraget, inkludert en kopi av det assistenten fikk tilbake. Partner og revisor i firmaet kan se hvilke opplysninger assistenten fikk.

Eksterne assistenter er avslått for nye firmaer. Partner slår på lesetilgang (Oversikt og status) under Firma → Abonnement. Registrering av oppstartsfakta og Registrering av bemanning er på som standard, og en partner kan slå dem av der. Slår partneren nivået av, stopper tilkoblingene for det nivået med en gang; slår de det på igjen, virker eksisterende tilkoblinger uten nytt samtykke. Innholdet sendes til assistentens leverandør, så bruk en bedriftskonto med databehandleravtale, der leverandøren ikke bruker innholdet til trening eller produktforbedring, og ikke en privat konto. Les personvernerklæringen før du kobler til.

Kontrollpunkter

Regler for agentintegrasjoner

Revly er laget for kontrollert revisjonsarbeid, ikke for skjulte eller autonome beslutninger.

  • Vis brukeren hva agenten skal lese eller endre før du kaller beskyttede funksjoner.
  • Send access tokens som Authorization: Bearer-header, aldri i URL-er eller logger.
  • Be om minst mulig tilgang og stopp hvis tilgang eller datagrunnlag mangler.
  • Ikke presenter et AI-forslag som revisors godkjenning eller konklusjon.
  • Bruk rate-limit- og HTTP-feil som signaler om retry, ikke som grunn til å gjenta en mutasjon ukritisk.

Spørsmål og svar

Det revisorer ofte spør om.

Er Revlys API åpent uten innlogging?

Kun offentlige discovery- og helseressurser er åpne uten innlogging. Revisjonsdata og produktfunksjoner krever godkjent bruker- og firmaadgang.

Finnes det et gratis sandbox-miljø?

Ikke som selvbetjent offentlig tjeneste i dag. Demoer og oppstart skjer med syntetiske eller anonymiserte data og menneskelig oppfølging.

Hvor finner jeg autentiseringsreglene?

Se auth.md og OAuth/OIDC-metadata under /.well-known. Den menneskelige godkjenningsprosessen på /bestill er en del av tilgangsmodellen.

Kan jeg koble Revly til ChatGPT, Claude, Grok eller Microsoft 365 Copilot?

Ja, når et tilgangsnivå er på under Firma → Abonnement. Registrering av oppstartsfakta og Registrering av bemanning er på som standard, og en partner kan slå dem av. Claude og Grok kobler du selv under Innstillinger → Sikkerhet. ChatGPT og Microsoft 365 Copilot setter Revly opp for firmaet. Skriv til support@revly.no. Tilgangen er personlig og gjelder ett firma. Den gir lesetilgang og de skrivenivåene du godkjenner, og du trekker den tilbake i Revly.

Se Revly i arbeid

Trenger du tilgang til en konkret integrasjon?

Ta kontakt om API-behov eller en gjennomgang av agentflyten. Første møte gjennomføres uten kundedata.