Dette register vedligeholdes for at opfylde EU’s Data Act-krav om et opdateret register, der giver oplysninger om datastrukturer, formater, relevante standarder og åbne interoperabilitetsspecifikationer for alle eksportérbare data.
Bemærk: denne side kan være genstand for ændringer.
Sidst opdateret: v.1.0. 12. september 2025.
Strukturer & formater
- OpenAPI (Swagger) – maskinlæselig REST-beskrivelse af endpoints.
- Dataformater: JSON
- Tidsstempler: Unix timestamp
- Dokumenter: base64
- Pagination: vær opmærksom på pagination. Læs mere her.
Anvendte standarder og åbne interoperabilitetsspecifikationer
- Penneo anvender et RESTful API-design med en standard, der har klare resource-endpoints.
- Penneo bruger JSON-dataformatet til enkel og universel dataudveksling.
- Penneo benytter OAuth 2.0 til autentificering og implementerer en sikker, åben standard for at give tredjepart adgang uden at dele adgangskoder.
- Penneo anvender TLS 1.2+ for at sikre, at alle overførte data er krypteret sikkert.
Adgang & autentificering
- Se venligst API Authentication.
- Vi anbefaler OAuth API keys grant.
- Organisationer har adgang til data på deres egen Penneo-miljø
Eksport af data
Gennem Penneo support:
- Kunden skal levere eller give tilladelse til, at Penneo kan oprette de nødvendige API-legitimationsoplysninger for at muliggøre fuldstændig eksport af kundedata.
- Penneo skal uploade de eksporterede kundedata til en gensidigt aftalt sikker fil-delingsplatform.
- Penneo skal give de personer, der er udpeget i kundens skiftemeddelelse, sikre legitimationsoplysninger til at få adgang til de eksporterede kundedata på den aftalte platform.
Brug af API:
- Autentificer ved brug af en af Penneos understøttede autentificeringsmetoder
- Brug af Super API-brugerens API-legitimationsoplysninger tillader eksport af data på kontoniveau.
- Bemærk venligst, at Super API-brugeren kun understøtter GET-forespørgsler.
- Hent en liste over alle sagsmapper ved brug af GET casefile list endpoint
- For store organisationer overvej pagination
- For hver casefileId brug GET casefile details endpoint
- Sagsmappe, dokument, underskriver og andre relevante data kan eksporteres fra svaret
- Brug documentId fra sagsmappens detaljer for at hente den base64-kodede PDF ved hjælp af GET the PDF document as a file
- For at identificere hvilken mappe sagsmappen er tilknyttet, brug GET the folder for the casefile
- Vedhæftninger kan identificeres på underskriveren ved brug af signerId på GET the meta data for files
- Ved brug af fileId kan filen downloades via GET the file
Bemærk 1: Se tilknyttet dokumentation for filtreringsmuligheder.
Bemærk 2: Det er ikke muligt at hente Active user list med userName, userId, email og role via API.
Eksporterbare data
Besøg venligst vores vilkår.