L'API de signature électronique Certyneo dans Postman
Importez la collection publique Certyneo dans Postman et testez chaque endpoint de l'API REST v1 — création d'enveloppes, envoi, suivi de statut, webhooks — avec des exemples de requêtes déjà renseignés.
Collection gratuite et publique. Une clé API Certyneo est nécessaire pour exécuter les requêtes.
Pourquoi utiliser la collection Postman Certyneo
La collection est pensée pour les développeurs qui veulent explorer l'API Certyneo sans lire toute la documentation avant de lancer leur première requête.
Requêtes prêtes à l'emploi
Chaque endpoint de l'API REST v1 est documenté avec un exemple de requête et de réponse, prêt à exécuter après avoir renseigné votre clé API.
Environnements de test
Une variable d'environnement Postman contient votre clé API et l'URL de base, pour basculer facilement entre vos comptes ou environnements.
Documentation générée automatiquement
La documentation Postman de la collection reste synchronisée avec le spec OpenAPI de l'API Certyneo — pas de décalage entre ce que vous testez et ce qui est en production.
Tester sans écrire de code
Créez une enveloppe, envoyez-la et suivez son statut directement depuis l'interface Postman, avant même d'intégrer l'API dans votre application.
Ce que couvre la collection
Un aperçu des groupes d'endpoints disponibles dans la collection publique.
| Groupe | Ce qu'il contient |
|---|---|
| Enveloppes | Créer, envoyer, lister, consulter et annuler une enveloppe de signature. |
| Documents | Téléverser un document ou l'importer depuis une URL (sourceUrl), consulter son statut. |
| Signataires | Ajouter des destinataires, définir leur ordre de signature et leur niveau (SES/AES). |
| Webhooks | Créer et gérer les abonnements aux événements de signature. |
| Envoi en masse | Envoyer plusieurs enveloppes en une seule requête pour les campagnes de signature en volume. |
La collection est publique en lecture : vous pouvez la consulter sans compte, mais l'exécution des requêtes nécessite une clé API Certyneo valide.
Commencer avec la collection en 4 étapes
Comptez moins de 5 minutes pour lancer votre première requête.
- 1
Importer la collection publique
Depuis Postman, ouvrez la collection publique Certyneo et cliquez sur « Fork » ou « Import » pour la copier dans votre propre espace.
- 2
Générer une clé API Certyneo
Dans votre tableau de bord Certyneo, ouvrez Paramètres → Clés API et créez une clé dédiée à Postman.
- 3
Renseigner la variable d'environnement
Collez votre clé API dans la variable d'environnement de la collection Postman, ainsi que l'URL de base de l'API.
- 4
Envoyer une première requête
Lancez la requête « Créer une enveloppe » et suivez le résultat directement dans Postman.
Sécurité et bonnes pratiques
Les requêtes de la collection passent par la même API que votre application en production : les mêmes règles de sécurité s'appliquent.
- Toutes les requêtes transitent en HTTPS/TLS 1.2 minimum.
- Chaque clé API est limitée aux permissions que vous lui accordez à sa création.
- Utilisez une clé de test dédiée pour vos essais Postman, distincte de votre clé de production.
- Une clé API compromise ou inutilisée se révoque en un clic depuis votre tableau de bord Certyneo.
Questions fréquentes
Faut-il un plan payant pour utiliser la collection Postman ?
Non. La collection est publique et gratuite. Les limites de votre plan Certyneo (nombre d'enveloppes, fonctionnalités) s'appliquent aux requêtes exécutées, comme pour tout usage de l'API.
Où trouver ma clé API ?
Dans votre tableau de bord Certyneo, sous Paramètres → Clés API. Créez une clé dédiée à vos tests Postman.
La collection est-elle à jour avec la dernière version de l'API ?
Oui, la collection est régénérée depuis le spec OpenAPI officiel de l'API Certyneo à chaque évolution de l'API REST v1.
Puis-je tester les webhooks depuis Postman ?
Oui, la collection contient les endpoints pour créer et lister vos abonnements webhooks. Pour recevoir les événements en local, utilisez un service de tunnel HTTP le temps de vos tests.
L'utilisation de la collection Postman a-t-elle un coût ?
Non, seule la consommation de l'API elle-même (création d'enveloppes) est décomptée de votre plan, exactement comme un appel API classique.
Pour aller plus loin
Testez l'API Certyneo dans Postman
Collection publique, gratuite, synchronisée avec notre documentation développeurs.