Premiers pas
Si vous souhaitez ajouter la signature électronique à votre propre système, l'API d'intégration Swisscom Sign vous offre un flux orienté backend pour créer, configurer, libérer et surveiller des processus de signature.
Ce guide suit le même cheminement que la documentation de référence Swisscom : comprendre le cycle de vie, choisir un style d'intégration, s'authentifier en OAuth2 et tester dans le bac à sable avant le passage en production. Avant la mise en production, consultez les conditions générales.
Modes d'intégration
Il existe deux modèles d'intégration courants :
- Utilisation des identifiants de vos clientes et clients. Dans ce modèle, les utilisateurs s'abonnent et gèrent l'accès pour leur propre organisation.
- Utilisation des identifiants de votre plateforme. Dans ce modèle, votre application propose la signature comme composante de votre propre produit et gère l'accès à l'API de façon centralisée.
Pour des configurations avancées telles que domaines personnalisés, certificats personnalisés, matériel cryptographique ou SSO, Swisscom prévoit un processus d'onboarding dédié.
Flux d'intégration typique
- Créer un processus avec
POST /api/process. - Attacher un ou plusieurs documents PDF.
- Libérer le processus directement ou le confier à l'interface de configuration.
- Ouvrir le flux de signature pour un signataire spécifique si vous avez besoin d'un lien profond.
- Interroger l'endpoint de statut jusqu'à ce que le processus soit terminé.
- Télécharger le document final et la piste d'audit.
Voir Concepts pour le cycle de vie complet et la référence des endpoints.
Utiliser l'API Explorer
L'onglet API Explorer de cette application charge le contrat OpenAPI en direct depuis Swisscom et fournit un client REST interactif pour l'authentification, l'inspection des payloads de requête et le test des endpoints.