Ce registre est maintenu conformément aux exigences du Data Act de l'UE. Il fournit les détails techniques sur les structures de données, les formats, les normes et les spécifications d'interopérabilité nécessaires à l'exportation des données depuis Penneo.
Remarque : Cette page est sujette à modification. Dernière mise à jour : v.1.0 — 12 septembre 2025.
Structures et formats de données
OpenAPI (Swagger) : Description REST des points de terminaison pour une lecture machine optimisée. (Lien à ajouter)
Formats de données : JSON.
Horodatages : Timestamp Unix.
Documents : Encodage Base64.
Pagination : Obligatoire pour la gestion des gros volumes. Pour en savoir plus : Lire ici.
Normes et interopérabilité
Penneo utilise des standards ouverts pour garantir un échange de données universel et sécurisé :
API RESTful : Architecture basée sur des ressources claires et normalisées.
OAuth 2.0 : Protocole sécurisé permettant l'accès aux tiers sans partage de mot de passe.
TLS 1.2+ : Chiffrement de haut niveau pour tous les transferts de données.
Accès et authentification
Les organisations ont accès exclusivement aux données de leur propre environnement Penneo.
Méthodes : Consultez la documentation sur l'authentification API ici.
Clés OAuth : Nous recommandons l'utilisation de clés API OAuth.
Configuration : Si vous êtes administrateur, créez vos Identifiants OAuth (clientId et clientSecret) depuis le menu de votre compte entreprise (Création d’un client OAuth) ainsi que vos Identifiants API via l'application web (API Key Management).
Procédures d'exportation des données
1. Via le support Penneo
Le client doit fournir ou autoriser Penneo à créer les identifiants API nécessaires pour l'export complet des données.
Penneo téléchargera les données exportées sur une plateforme de partage de fichiers sécurisée convenue mutuellement.
Penneo fournira les accès sécurisés aux personnes désignées dans l'Avis de Changement du Client.
2. Via l'API (Self-service)
L'utilisation des identifiants de l'utilisateur Super API permet l'exportation des données au niveau du compte. Veuillez noter que l'utilisateur Super API supporte uniquement les requêtes GET.
Authentification : Authentifiez-vous en utilisant l'une des méthodes prises en charge par Penneo.
Liste des dossiers : Obtenez une liste de tous les dossiers en utilisant le point de terminaison GET liste des dossiers.
Note : Considérez la pagination pour les grandes organisations.
Détails et tournée de signature : Pour chaque
casefileId, utilisez le point de terminaison GET détails du dossier.
Les données du dossier, du document, des signataires et de la tournée de signature peuvent être exportées depuis la réponse.
Documents PDF : Utilisez le
documentIdissu des détails du dossier pour obtenir le PDF encodé en base64 via GET le document PDF en tant que fichier.
Lien du dossier : Pour identifier le dossier parent auquel le dossier de signature est lié, utilisez GET le dossier pour le dossier.
Pièces jointes : Les pièces jointes peuvent être identifiées sur le signataire en utilisant le
signerIdsur GET les métadonnées des fichiers.
Téléchargement des fichiers : En utilisant le
fileId, le fichier peut être téléchargé via GET le fichier.
Notes importantes :
Note 1 : Voir la documentation liée pour les options de filtrage. (Lien à ajouter)
Note 2 : Il n'est pas possible de récupérer la liste des utilisateurs actifs avec userName, userId, email, et role via l'API.
Données exportables
Pour consulter la liste exhaustive des données exportables, veuillez vous référer à nos conditions.