{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Référence API","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"référence-api","__idx":0},"children":["Référence API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["L'API Namirial Sign Enterprise (v1) est une API RESTful qui permet de créer, gérer et suivre des workflows de signature électronique de manière programmatique. Vous pouvez l'utiliser pour intégrer NSE dans vos propres applications, automatiser l'envoi d'enveloppes ou créer des portails de signature personnalisés."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La spécification API interactive est disponible ci-dessous — utilisez-la pour explorer les points de terminaison, inspecter les schémas de requête et de réponse, et effectuer des appels directement."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"url-de-base","__idx":1},"children":["URL de base"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tous les points de terminaison de l'API sont relatifs à l'URL de base de votre instance NSE :"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Par exemple"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://demo-eu-ie1-api.namirialsign.com/api/\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La plupart des points de terminaison incluent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}," comme paramètre de chemin obligatoire (assurez-vous de le renseigner à chaque utilisation de l'API). Il s'agit de l'identifiant de l'organisation, dans votre instance NSE, propriétaire de la ressource concernée."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"principes-de-lapi-v1","__idx":2},"children":["Principes de l'API v1"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sémantique REST complète"]}," — utilise les verbes GET, POST, PUT, PATCH et DELETE selon les conventions REST standard."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ressources rattachées à une organisation"]}," — toutes les ressources, à l'exception des données de référence, sont rattachées à ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/organizations/{organizationId}/"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workflow basé sur des étapes"]}," — les workflows de signature sont modélisés sous forme d'",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["étapes"]}," ordonnées. Les destinataires d'une même étape signent en parallèle ; les étapes sont traitées séquentiellement selon leur ordre de tri."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Séparation de la structure et du contenu"]}," — les fichiers, étapes et destinataires sont gérés comme des sous-ressources indépendantes d'une enveloppe ou d'un modèle, permettant un contrôle précis de chaque partie du workflow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Artefacts pour les documents finalisés"]}," — une fois une enveloppe terminée, les documents signés et la piste d'audit sont accessibles sous forme d'",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["artefacts"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentification","__idx":3},"children":["Authentification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["L'authentification à l'API utilise OAuth 2.0 Client Credentials, avec MyNamirial comme fournisseur d'identité."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configuration","__idx":4},"children":["Configuration"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Créez une ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["application IdP"]}," (compte de service)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Notez l'",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ID client"]}," et le ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["secret client"]}," attribués à l'application."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remarque :"]}," la création d'un IdP dans MyNamirial et la génération du ClientID et du ClientSecret peuvent être effectuées dans l'interface, dans la section des comptes de service. Pour plus d'informations, voir : ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/users"},"children":["Compte de service"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"obtenir-un-jeton","__idx":5},"children":["Obtenir un jeton"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Utilisez le flux Client Credentials pour obtenir un jeton Bearer JWT."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"jeton-daccès-personnel","__idx":6},"children":["Jeton d'accès personnel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il est également possible de créer un jeton d'accès personnel pour utiliser l'API. Pour plus d'informations, voir : ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/02-products-and-modules/01-nse/02-nse-settings/user-account-settings"},"children":["Jeton d'accès"]},". Ajoutez l'en-tête « Personal-Access-Token » avec le jeton obtenu comme valeur."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"utiliser-le-jeton","__idx":7},"children":["Utiliser le jeton"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Incluez le jeton comme jeton Bearer dans l'en-tête ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," de chaque requête API :"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer <access_token>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les requêtes non authentifiées ou avec un jeton expiré renvoient ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"concepts-clés","__idx":8},"children":["Concepts clés"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"enveloppe","__idx":9},"children":["Enveloppe"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une enveloppe représente une demande de signature unique. Elle contient un ou plusieurs documents (fichiers), un workflow de signature (étapes) et des options d'enveloppe telles que le nom, la date d'expiration et la configuration des rappels."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cycle de vie d'une enveloppe :"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Statut"},"children":["Statut"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Draft (Brouillon)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Créée mais pas encore envoyée. Toute la configuration peut être modifiée."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["InProgress (En cours)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envoyée aux destinataires. Le workflow de signature est en cours."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Completed (Terminée)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tous les destinataires ont terminé leurs activités. Les artefacts sont disponibles au téléchargement."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Canceled (Annulée)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Annulée manuellement. Plus aucune activité n'est possible."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expired (Expirée)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La date d'expiration a été atteinte avant la finalisation. Peut être reprise avec une nouvelle date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rejected (Rejetée)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L'enveloppe a été rejetée par un ou plusieurs destinataires."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"modèle","__idx":10},"children":["Modèle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un modèle est une configuration d'enveloppe réutilisable — préchargée avec des documents, des étapes, des destinataires et des emplacements de champs. Créer une enveloppe à partir d'un modèle copie l'intégralité de la configuration dans une nouvelle enveloppe au statut Brouillon, qui peut être personnalisée avant l'envoi."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"étape","__idx":11},"children":["Étape"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une étape représente une phase du workflow de signature. Chaque étape contient un ou plusieurs destinataires qui agissent en parallèle. Les étapes sont traitées séquentiellement par ordre croissant de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sortOrder"]},". Utilisez ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requiredRecipientCompletions"]}," pour permettre à une étape de progresser lorsqu'un nombre minimum de destinataires (sur le total) ont terminé leur activité — utile pour les scénarios de signature de groupe."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"destinataire","__idx":12},"children":["Destinataire"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un destinataire est une personne assignée à une étape. Chaque destinataire dispose de coordonnées (e-mail, nom, téléphone), d'un canal de notification (E-mail, SMS, WhatsApp ou Aucun), d'une préférence de langue, d'exigences d'authentification facultatives (code d'accès, OTP par SMS, OAuth) et d'une configuration de signature facultative (type de signature et données pré-remplies requises)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fichier-et-tâches","__idx":13},"children":["Fichier et tâches"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un fichier est un document joint à une enveloppe ou un modèle. Les ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tâches"]}," sont les éléments interactifs assignés aux destinataires — champs de signature, saisies de texte, cases à cocher, listes déroulantes, demandes de pièces jointes et lectures de confirmation. La plupart des tâches sont positionnées sur une page précise d'un fichier, mais certaines (comme les lectures de confirmation) s'appliquent au niveau du fichier ou de la page, sans position fixe."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"artefact","__idx":14},"children":["Artefact"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une fois qu'une enveloppe atteint le statut ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Completed (Terminée)"]},", ses fichiers de sortie deviennent disponibles sous forme d'artefacts. Il existe deux types d'artefacts : ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CompletedFile"]}," (le document signé) et ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AuditTrail"]}," (le journal complet des événements au format PDF)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"types-de-signature-pris-en-charge","__idx":15},"children":["Types de signature pris en charge"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClickToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature simple par clic de confirmation — sans certificat cryptographique."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DrawToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature manuscrite dessinée, capturée dans le navigateur ou sur un appareil tactile."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TypeToSignSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature créée en saisissant le nom du destinataire dans une police choisie."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LocalCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature utilisant un certificat installé sur l'appareil local du destinataire."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DisposableCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature utilisant un certificat qualifié à usage unique, généré au moment de la signature."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BiometricSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature capturée via une tablette biométrique (pression et dynamique du stylet)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RemoteCertificateSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature utilisant un certificat qualifié distant (nécessite ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userId"]}," et ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceId"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OneTimePasswordSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature confirmée via un code OTP envoyé par SMS au numéro de téléphone du destinataire."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AutomaticSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature appliquée sans aucune interaction nécessaire."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PluginSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature déléguée à un plugin de signature personnalisé configuré sur l'instance."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"gestion-des-erreurs","__idx":16},"children":["Gestion des erreurs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Toutes les réponses d'erreur suivent une structure cohérente :"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"errorId\": \"string\",\n      \"field\": \"string\",\n      \"message\": \"string\",\n      \"messageEn\": \"string\",\n      \"additionalData\": {}\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Statut HTTP"},"children":["Statut HTTP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Signification"},"children":["Signification"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La requête a réussi."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La ressource a été créée. L'ID de la nouvelle ressource est renvoyé dans le corps de la réponse."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204 No Content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La requête a réussi sans corps de réponse (mise à jour ou suppression)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La requête est invalide ou mal formée."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L'authentification est absente ou le jeton a expiré."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L'utilisateur authentifié n'a pas les droits d'accès à cette ressource."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404 Not Found"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La ressource demandée n'existe pas."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422 Unprocessable Entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La requête est valide mais viole une règle métier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500 Internal Server Error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Une erreur inattendue s'est produite sur le serveur."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"workflow-dintégration-type","__idx":17},"children":["Workflow d'intégration type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une intégration type pour l'envoi d'une demande de signature suit les étapes suivantes :"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Créer une enveloppe"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Téléverser un document"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/files"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ajouter une étape de signature"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/stages"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ajouter un destinataire à l'étape"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Placer les tâches de champs sur le document"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Envoyer l'enveloppe"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/envelopes/{envelopeId}/send"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vérifier l'enveloppe"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /organizations/{organizationId}/envelopes/{envelopeId}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Télécharger les artefacts"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /organizations/{organizationId}/envelopes/{envelopeId}/artifacts"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pour créer une enveloppe à partir d'un modèle, remplacez les étapes 1 à 5 par :"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Créer une enveloppe à partir d'un modèle"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /organizations/{organizationId}/templates/{templateId}/create-envelope"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mettez éventuellement à jour les destinataires ou les fichiers dans le brouillon, puis procédez à l'envoi."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"spécification-de-lapi","__idx":18},"children":["Spécification de l'API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La spécification API interactive complète est disponible sur l'interface Swagger UI de votre instance NSE. Contactez votre représentant Namirial pour obtenir l'URL correcte pour votre environnement."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le Swagger UI de DÉMONSTRATION est disponible à cette URL :"," ","https://demo-eu-ie1-api.namirialsign.com/api/swagger/index.html"]}]},"headings":[{"value":"Référence API","id":"référence-api","depth":1},{"value":"URL de base","id":"url-de-base","depth":2},{"value":"Principes de l'API v1","id":"principes-de-lapi-v1","depth":2},{"value":"Authentification","id":"authentification","depth":2},{"value":"Configuration","id":"configuration","depth":3},{"value":"Obtenir un jeton","id":"obtenir-un-jeton","depth":3},{"value":"Jeton d'accès personnel","id":"jeton-daccès-personnel","depth":3},{"value":"Utiliser le jeton","id":"utiliser-le-jeton","depth":3},{"value":"Concepts clés","id":"concepts-clés","depth":2},{"value":"Enveloppe","id":"enveloppe","depth":3},{"value":"Modèle","id":"modèle","depth":3},{"value":"Étape","id":"étape","depth":3},{"value":"Destinataire","id":"destinataire","depth":3},{"value":"Fichier et tâches","id":"fichier-et-tâches","depth":3},{"value":"Artefact","id":"artefact","depth":3},{"value":"Types de signature pris en charge","id":"types-de-signature-pris-en-charge","depth":2},{"value":"Gestion des erreurs","id":"gestion-des-erreurs","depth":2},{"value":"Workflow d'intégration type","id":"workflow-dintégration-type","depth":2},{"value":"Spécification de l'API","id":"spécification-de-lapi","depth":2}],"frontmatter":{"seo":{"title":"Référence API"}},"lastModified":"2026-10-19T12:00:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/api-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}