Aller au contenu principal

Guide de l’API LibreSign

10 oct. 2024

API LibreSign : intégration à d’autres systèmes

Mis à jour le 10 novembre 2026. Publication initiale : 10 octobre 2024.

LibreSign est un logiciel libre et gratuit de signature électronique pour Nextcloud. Son API REST, fondée sur le protocole OCS de Nextcloud, permet à un système externe de demander des signatures, de suivre leur avancement et de valider des documents. Une application existante peut conserver sa propre interface et ses processus, tandis que son serveur communique avec LibreSign. L’API est incluse dans le logiciel : aucun achat d’accès distinct n’est nécessaire. L’hébergement, les prestations d’intégration et l’assistance sont facultatifs.

Documentation officielle d’intégration

Commencez par consulter la documentation officielle de LibreSign. Sélectionnez la version de LibreSign installée sur votre serveur Nextcloud, puis ouvrez la rubrique Developer manual and API. Vous y trouverez des guides d’intégration, des exemples pratiques, une référence OpenAPI interactive et son contrat JSON téléchargeable. Les guides abordent les demandes de signature, les invitations, la consultation des statuts et la récupération autorisée des documents signés.

Utilisez la documentation correspondant à votre version : les fonctionnalités disponibles et les champs des requêtes peuvent évoluer. La documentation de développement peut présenter des fonctions qui ne figurent pas encore dans une version stable.

Authentification et intégration à des systèmes externes

Pour une intégration de serveur à serveur, utilisez HTTPS et un compte Nextcloud autorisé, avec un mot de passe d’application révocable. Les requêtes OCS utilisent généralement l’authentification HTTP Basic et l’en-tête OCS-APIRequest: true. Conservez les identifiants sur votre serveur, jamais dans le code exécuté côté client. La prise en charge des jetons Bearer dépend de la configuration d’authentification de votre instance Nextcloud : se connecter à une autre application ne donne pas automatiquement accès à l’API.

Votre serveur peut créer des demandes de signature et suivre leur état à l’aide des points de terminaison documentés. Selon les paramètres activés dans LibreSign, les destinataires peuvent signer avec leur compte Nextcloud ou au moyen d’invitations individuelles, sans créer de compte Nextcloud. Le compte d’intégration ne doit pas servir à usurper l’identité des signataires.

L’inspection du navigateur est un outil de diagnostic

L’onglet Réseau du navigateur (F12) et l’OCS API Viewer peuvent aider à analyser les requêtes et les réponses d’une installation donnée. Ce sont des outils de diagnostic complémentaires, pas des substituts au contrat OpenAPI officiel : les appels observés dans le navigateur peuvent dépendre de cookies de session ou du fonctionnement de l’interface. Consultez d’abord les guides et exemples versionnés, et veillez à ne pas divulguer d’identifiants, de liens de signature ni de contenus documentaires lors du débogage.