LibreSign-API: Integrasjon med andre systemer
Oppdatert 10. november 2026. Opprinnelig publisert 10. oktober 2024.
LibreSign er fri programvare med åpen kildekode for elektroniske signaturer i Nextcloud. REST-API-et bygger på Nextclouds OCS-protokoll og lar eksterne systemer opprette signeringsforespørsler, følge fremdriften og validere dokumenter. En eksisterende applikasjon kan beholde sitt eget grensesnitt og sine arbeidsflyter, mens backend-systemet kommuniserer med LibreSign. API-et følger med programvaren. Du trenger ikke kjøpe separat API-tilgang. Hosting, integrasjonstjenester og brukerstøtte er valgfrie tjenester.
Offisiell integrasjonsdokumentasjon
Start med den offisielle LibreSign-dokumentasjonen. Velg LibreSign-versjonen som er installert på Nextcloud-serveren din, og åpne Utviklerhåndbok og API (Developer manual and API). Der finner du integrasjonsveiledninger, praktiske eksempler, en interaktiv OpenAPI-referanse og en nedlastbar JSON-kontrakt. Veiledningene dekker signeringsforespørsler, invitasjoner, statuskontroll og autorisert nedlasting av signerte dokumenter.
Bruk dokumentasjonen som gjelder den installerte versjonen. Tilgjengelige funksjoner og forespørselsfelter kan endres mellom versjoner. Dokumentasjonen for utviklingsversjonen kan beskrive funksjoner som ennå ikke er tilgjengelige i en stabil utgave.
Autentisering og integrasjon med eksterne systemer
Ved integrasjon mellom servere skal du bruke HTTPS og en autorisert Nextcloud-konto med et tilbakekallbart app-passord (App Password). OCS-forespørsler bruker vanligvis HTTP Basic-autentisering og headeren OCS-APIRequest: true. Oppbevar påloggingsopplysninger i backend-systemet, aldri i klientkode. Støtte for bearer-token avhenger av autentiseringsoppsettet i Nextcloud-instansen. Innlogging i en annen applikasjon gir ikke automatisk tilgang til API-et.
Backend-systemet kan opprette signeringsforespørsler og kontrollere statusen gjennom de dokumenterte endepunktene. Avhengig av LibreSign-innstillingene kan mottakere signere med Nextcloud-kontoen sin eller via personlige invitasjoner uten å opprette en Nextcloud-konto. En integrasjonskonto må ikke brukes til å utgi seg for å være en underskriver.
Inspeksjon i nettleseren er et feilsøkingsverktøy
Nettleserens nettverksfane (F12) og OCS API Viewer kan bidra til å undersøke forespørsler og svar i en bestemt installasjon. De utfyller hverandre ved feilsøking, men er ikke en erstatning for den offisielle OpenAPI-kontrakten. Nettleserforespørsler kan være avhengige av øktinformasjonskapsler eller atferd som er spesifikk for brukergrensesnittet. Bruk de versjonerte veiledningene og eksemplene først, og unngå å eksponere påloggingsopplysninger, signeringslenker eller dokumentinnhold under feilsøking.