Alt i Visena.
Ett API unna.

Det partnerne våre bygger

Din programvare, Visena under

Uansett hva selskapet driver på Visena, gjør Partner API det programmerbart. Fire mønstre dekker det meste partnere spør oss om.

Å gjøre kall → Lister, paginering og synk →

Se det i praksis

Ekte kall, ikke lysbilder

Ren HTTPS og JSON, standard OAuth 2.0 — kan teamet ditt kalle et REST-API, kan det bygge på Visena. Hvert kall har samme form: instansnavnet, API-versjonen, en locale, og så ressursen. Slik ser de daglige grepene ut.

Opprett poster i stor skala

Sjekk for duplikater først, opprett så. Selskaper med kjent organisasjonsnummer er beskyttet — API-et nekter å opprette det samme selskapet to ganger, en feil referanse skriver ingenting i det hele tatt, og hver importerte post viser hvem som lastet den inn.

# any duplicates before we create?
GET /acme/api/v1/en/company/duplicates?orgNumber=983163327

# clear — create the client company
POST /acme/api/v1/en/company
{ "name": "Fjellheim Regnskap AS",
  "orgNumber": "983163327" }

→ 201 Created · Location: …/company/bQ4wR8

Gå gjennom hele datasettet

Cursor-paginering er laget for ett konsistent uttrekk: start på første side, følg links.next til slutt, og du har datasettet i én gjennomgang, filtrert til nøyaktig den delen du trenger. Den er ikke et grunnlag for å gjenoppta en synkronisering — en id tildeles ved første skriving, ikke ved commit, så en rad som blir committet utenfor id-rekkefølge kan havne bak en gjennomgang som allerede har passert den. Å gjenoppta er det den tidsvinduede timeline er til for: også cursor-paginert, og «minst én gang», så dedupliser på id. Ingen av listemodusene rapporterer slettinger — for arkivet er document/changes den eneste lesestien der en sletting er synlig.

GET /acme/api/v1/en/person/cursor?limit=100

{ "items": [ …100 people… ],
  "links": { "next": "…/person/cursor?cursor=eyJp…" } }

# follow links.next until it disappears — export complete

Bare det som er endret

Hver ressurs har en endringsstrøm: alt som er opprettet eller endret siden et tidspunkt du velger. Ett tidsmerke, ett kall — ingen full gjennomlesing og ingen diffing på din side, enten du kjører hvert femte minutt eller én gang i døgnet.

# everything that changed since last night's run
GET /acme/api/v1/en/person/timeline?since=2026-08-20T02:00:00Z

{ "items": [ …created & modified people… ],
  "links": { "next": "…" } }

# apply, store the new watermark, done

Arkivet, programmerbart

Last opp filer på kunden eller oppdraget de hører til, organiser dem i mapper, og hent hele mappetrær tilbake som zip-pakker. Ekte binærfiler går inn og ut, ikke bare metadata, og en konfliktregel avgjør om en eksisterende fil erstattes, hoppes over eller beholdes ved siden av den nye.

# file the signed engagement letter on the client
POST /acme/api/v1/en/document   (multipart)
  file=@engagement-letter.pdf
  entityType=COMPANY  entityId=bQ4wR8

→ 201 Created · Location: …/document/dN3pT7

# later: the whole folder tree as one zip
GET /acme/api/v1/en/document/folder/fR2kX9/content

Presise endringer fra din egen frontend

Merge-patch-oppdateringer endrer nøyaktig de feltene du sender og ingenting annet — ideelt bak et skjema i din egen portal. Handler du for en navngitt bruker? Svaret registrerer begge identitetene: personen endringen ble gjort for, og hva som gjorde den.

PATCH /acme/api/v1/en/person/xK9mQ2
Content-Type: application/merge-patch+json

{ "jobTitle": "Head of Operations",
  "directPhone": null }          ← cleared; the rest untouched

→ 200 OK · modified + modifiedBy recorded

Hvorfor revisjonsselskaper spesielt

Etterrettelighet er ikke en funksjon vi la til. Det er måten API-et er bygget på.

Virksomheten deres er tillit og sporbarhet. En integrasjonsflate som gjør det uklart hvem som gjorde hva, ville vært diskvalifiserende — vår gjør det aldri.

• ✓Hver skriving har et navn på seg. Endringer via API-et tilskrives en virkelig person i instansen deres — eieren av legitimasjonen — akkurat som endringer gjort i Visena selv. Maskinaktivitet er aldri anonym.
• ✓Å handle for noen registreres som nettopp det. On-behalf-legitimasjon lar et system handle for en navngitt ansatt, og hver endring registrerer både personen det ble handlet for og aktøren bak. To identiteter, ett revisjonsspor.
• ✓Destruktive handlinger krever uttrykkelig vilje. Slettinger som ville forplantet seg videre, avvises til de er bekreftet i forespørselen. Duplikate organisasjonsnumre blokkeres helt. API-et gjør det uforsiktige vanskelig.
• ✓GDPR-verktøy inkludert. Endepunkter for sletting av personopplysninger i tråd med regelverket, og planlagte slettedatoer, er del av API-et — personvernforpliktelser håndtert gjennom samme grensesnitt som alt annet.
• ✓Streng isolering mellom instanser. Legitimasjon og tokener er bundet til én instans. Dataene deres ligger bak en vegg, ikke i en mappe — et token for én kunde kan aldri berøre en annen.
• ✓Ingen innlåsing, skriftlig. Full eksport er en dokumentert, støttet og førsteklasses mulighet. Vi beholder kunder ved å være gode, ikke ved å holde data som pant.

Sikkerhet, uten seremoni

Låst som standard, åpent på dine vilkår

Sikkerhetsmodellen er den samme vi stoler på i vår egen plattform — og den holder seg unna veien for utviklerne dine.

• ✓Kortlevde tokener med avgrenset omfang. Tilgangstokener utløper av seg selv, og scope er obligatorisk ved utstedelse: en tokenforespørsel uten scope= avvises med invalid_scope. Lese/skrive-skillet håndheves deretter per forespørsel, i et filter foran endepunktet — en skrivebeskyttet eksportjobb er ikke i stand til å skrive i det hele tatt.
• ✓Hemmeligheter vises én gang, lagres aldri. Hemmeligheten til en legitimasjon vises én enkelt gang og oppbevares bare som en enveis hash. Ikke engang Visena kan lese den tilbake.
• ✓Tilbakekalling på under ett minutt. Tilbakekall en legitimasjon, og hvert token den noen gang har utstedt slutter å virke innen omtrent seksti sekunder. Å avslutte en leverandør er ett kall.

Profesjonelt av design

Standarder utviklerne dine allerede kjenner

Ingen proprietær SDK, ingen eksotisk protokoll. Partner API er bygget på de åpne standardene alle integrasjonsteam snakker — derfor skjer de første kallene på en ettermiddag, ikke i en sprint.

Maskinlesbare feil, navigerbare pagineringslenker, presise delvise oppdateringer — konvensjonene er kjedelige med vilje. Kjedelig er det som integrerer godt, og det som fortsatt integrerer godt om fem år.

Kom i gang

Fra første samtale til produksjon

Ingen anskaffelseslabyrint, ingen seks ukers innføringsprogram. Dette er hele reisen.

• 1Snakk med oss. Fortell oss hva du vil bygge — skriv til sales@visena.com. Vi går gjennom API-et med deg og avtaler den tilgangen integrasjonen trenger.
• 2Få legitimasjonen din. Opprettet på minutter inne i Visena-instansen — et navngitt par av clientId og hemmelighet, som kan tilbakekalles når som helst.
• 3Gjør ditt første kall. Én OAuth 2.0-tokenforespørsel, så ren REST. Kom-i-gang-guiden får teamets første forespørsel til å virke samme ettermiddag.
• 4Sett i produksjon, med støtte videre. Rull ut med tokener med avgrenset omfang og en innøvd rutine for rotering — sjekklisten for produksjon tar den siste biten — og en navngitt kontaktperson i Visena når du trenger en.

Guidene nedenfor dekker legitimasjon, tokener, scopes, paginering og feilhåndtering, og referansen dokumenterer hvert endepunkt. Utviklerne dine kjenner seg hjemme i løpet av den første timen.

Spørsmålene vi får først

De korte svarene

Trenger vi en SDK eller spesialverktøy?

Nei. API-et er ren HTTPS med JSON-kropper og standard OAuth 2.0. Alle språk, alle HTTP-klienter og alle integrasjonsplattformer som kan sende en forespørsel fungerer — de fleste team gjør sitt første kall med ingenting annet enn curl.

Kan vi få dataene våre ut igjen?

Ja — fullstendig, og uten å spørre oss. Cursor-paginering går gjennom et helt datasett i én gjennomgang, timeline gjenopptar synkroniseringen etterpå, og dokumenter lastes ned som filer eller hele mappetrær. Å komme seg ut er en støttet funksjon, ikke en forhandling.

Går API-aktivitet rundt forretningsreglene i Visena?

Aldri. Skrivinger via API-et går gjennom samme validering og forretningslogikk som Visenas egne skjermbilder, og lander med samme sporbarhet. Det som er ugyldig i grensesnittet, er ugyldig gjennom API-et — dataene deres holder seg konsistente uansett hvilken dør de kom inn gjennom.

Hvem kontrollerer tilgangen, og hvor raskt kan den kuttes?

Kunden gjør det. Legitimasjon opprettes inne i kundens egen Visena-instans, avgrenset til nøyaktig de rettighetene integrasjonen trenger, og kan tilbakekalles med ett kall — hvert token dør innen omtrent ett minutt. Hemmeligheter vises én gang og lagres bare som en enveis hash.

Kan en integrasjon handle på vegne av en bestemt ansatt?

Ja. On-behalf-legitimasjon utstedes av kundens administrator for en navngitt bruker. Hver endring registrerer da begge identitetene — hvem det ble gjort for, og hva som gjorde det — som er nøyaktig det sporet en revisjonsmetodikk forventer.

Hva koster det?

Det avhenger av hva du bygger og hvilken skala du planlegger for. Snakk med kontaktpersonen din i Visena, eller skriv til sales@visena.com, så setter vi sammen vilkår som passer.