{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Référence des erreurs","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-des-erreurs","__idx":0},"children":["Référence des erreurs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Chaque endpoint de l'API NSE utilise un ensemble cohérent de codes de statut HTTP. Cette référence décrit la signification de chaque code, la structure du corps de la réponse le cas échéant, et les actions à entreprendre en cas d'erreur."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"codes-de-statut-http","__idx":1},"children":["Codes de statut HTTP"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"400-bad-request","__idx":2},"children":["400 Bad Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La requête était structurellement invalide — un champ requis était absent, une valeur était du mauvais type, une valeur d'énumération n'était pas reconnue, ou un champ a échoué à une vérification de format (p. ex. une chaîne devant être un UUID)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le corps de la réponse est un objet ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorsResponse"]}," contenant une ou plusieurs entrées d'erreur identifiant précisément le champ ou la règle ayant causé le rejet."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action à entreprendre :"]}," Lire les détails de l'erreur dans le corps de la réponse. Corriger le contenu de la requête avant de réessayer. Ne pas réessayer avec la même requête sans modification — elle échouera à nouveau."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Causes courantes :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un champ requis est absent (p. ex. pas de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," sur une étape)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Une valeur d'énumération est en mauvaise casse ou mal orthographiée (p. ex. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"signer\""]}," au lieu de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Signer\""]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un champ UUID contient une valeur qui n'est pas un UUID valide"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un champ date-heure n'est pas au format ISO 8601"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"401-unauthorized","__idx":3},"children":["401 Unauthorized"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La requête ne contenait pas de Bearer token valide, ou le token a expiré."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action à entreprendre :"]}," Obtenir un nouveau JWT token et réessayer la requête avec l'en-tête ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer {token}"]}," mis à jour. Ne pas réessayer avec le même token s'il a expiré."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"403-forbidden","__idx":4},"children":["403 Forbidden"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le token est valide, mais l'utilisateur authentifié n'a pas l'autorisation d'effectuer cette opération. Cela signifie généralement que l'utilisateur ne dispose pas du rôle requis ou n'appartient pas à l'organisation spécifiée dans le chemin."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action à entreprendre :"]}," Vérifier que l'",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}," dans le chemin de la requête correspond à l'organisation à laquelle appartient l'utilisateur, et que l'utilisateur dispose des autorisations nécessaires. Il ne s'agit pas d'une erreur transitoire — réessayer ne résoudra pas le problème."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"404-not-found","__idx":5},"children":["404 Not Found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La ressource référencée dans le chemin n'existe pas. Cela s'applique aux enveloppes, étapes, destinataires, fichiers et artefacts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action à entreprendre :"]}," Vérifier que les identifiants dans le chemin de la requête sont corrects et que la ressource a bien été créée avant cet appel. Une erreur ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}," sur une ressource récemment créée peut indiquer qu'un appel de création précédent a échoué silencieusement ou qu'un mauvais identifiant est utilisé."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"422-unprocessable-content","__idx":6},"children":["422 Unprocessable Content"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La requête était structurellement valide, mais n'a pas pu être exécutée en raison d'une violation de règle métier. L'entité existe et la requête est bien formée, mais l'opération n'est pas autorisée dans l'état actuel."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le corps de la réponse est un objet ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorsResponse"]}," avec des détails sur la règle violée."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action à entreprendre :"]}," Lire les détails de l'erreur. La correction dépend de la règle spécifique — les scénarios courants incluent :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tentative de modification d'une enveloppe déjà envoyée"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tentative d'envoi d'une enveloppe sans destinataires ni fichiers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Placement d'une tâche de champ pour un ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientId"]}," n'appartenant pas à l'enveloppe"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tentative de création d'une ressource sur une enveloppe dont le statut n'est pas ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["draft"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"500-internal-server-error","__idx":7},"children":["500 Internal Server Error"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Une erreur inattendue s'est produite côté serveur. Elle n'est pas causée par le contenu de la requête."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action à entreprendre :"]}," Réessayer la requête après un court délai. Si l'erreur persiste, cela indique un problème de plateforme. Contacter le support Namirial avec les détails de la requête et l'horodatage afin que l'incident puisse être investigué."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"le-corps-errorsresponse","__idx":8},"children":["Le corps ErrorsResponse"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Les réponses d'erreur incluent un corps d'erreur structuré. Le schéma est nommé ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorsResponse"]}," et contient une liste d'entrées d'erreur décrivant ce qui s'est passé."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remarque : Les noms exacts des champs du schéma ErrorsResponse ne sont pas confirmés par la spécification API actuelle. Inspecter le corps de la réponse réelle dans l'intégration pour déterminer la structure précise. Le corps sera toujours au format JSON."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tableau-de-référence-rapide","__idx":9},"children":["Tableau de référence rapide"]},{"$$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":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Nom"},"children":["Nom"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action requise"},"children":["Action requise"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bad Request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Corriger le contenu de la requête"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unauthorized"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Renouveler le Bearer token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Forbidden"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vérifier l'identifiant de l'organisation et les autorisations de l'utilisateur"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not Found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vérifier que l'identifiant de la ressource existe"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unprocessable Content"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Corriger la violation de règle métier"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["429"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Too Many Requests"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Implémenter un backoff, réduire la fréquence des appels"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal Server Error"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Réessayer ; contacter le support si le problème persiste"]}]}]}]}]}]},"headings":[{"value":"Référence des erreurs","id":"référence-des-erreurs","depth":1},{"value":"Codes de statut HTTP","id":"codes-de-statut-http","depth":2},{"value":"400 Bad Request","id":"400-bad-request","depth":3},{"value":"401 Unauthorized","id":"401-unauthorized","depth":3},{"value":"403 Forbidden","id":"403-forbidden","depth":3},{"value":"404 Not Found","id":"404-not-found","depth":3},{"value":"422 Unprocessable Content","id":"422-unprocessable-content","depth":3},{"value":"500 Internal Server Error","id":"500-internal-server-error","depth":3},{"value":"Le corps ErrorsResponse","id":"le-corps-errorsresponse","depth":2},{"value":"Tableau de référence rapide","id":"tableau-de-référence-rapide","depth":2}],"frontmatter":{"seo":{"title":"Référence des erreurs"}},"lastModified":"2026-07-01T08:50:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/error-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}