--- title: "Gestion des expéditeurs" slug: "managing-senders" updated: 2025-02-27T13:37:53Z published: 2025-02-27T13:37:53Z canonical: "docs.onespan.com/managing-senders" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Gestion des expéditeurs [SDK Java](/v1/docs/fr/managing-senders#sdk-java) [.NET SDK](/v1/docs/fr/managing-senders#net-sdk) [API REST](/v1/docs/fr/managing-senders#api-rest) ## SDK Java Pour télécharger l'exemple complet de code, consultez notre site [Partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/managing-senders-java-sdk/). OneSpan Sign vous offre la possibilité d'ajouter des utilisateurs à votre compte, leur permettant de créer et d'envoyer des transactions pour la signature numérique. En tant que propriétaire du compte, vous aurez accès aux transactions créées par vos utilisateurs. Cependant, vous ne pouvez récupérer ces transactions qu'en utilisant les SDK ou les API. Si vous voulez accéder à ces transactions à l'aide de l'interface Web, vous devrez demander à vos utilisateurs de vous déléguer l'accès. OneSpan Sign vous permet d'accorder à d'autres personnes de votre organisation l'accès à votre compte. Avec la Access Delegation, le délégué que vous avez désigné (la personne à laquelle vous avez accordé un accès) peut envoyer et signer des documents en votre nom. Pour obtenir plus d'informations, voir [Délégation d'accès](/v1/docs/fr/delegating-access#sdk-java). ### Trouver vos utilisateurs dans l'interface utilisateur Tout d'abord, localisez vos expéditeurs dans l'interface Web OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign et cliquez sur Admin > Utilisateurs. Après avoir exécuté votre code, tous vos utilisateurs apparaîtront ici. La page Utilisateurs remplace la page Expéditeurs si l'option Rôles et permissions a été activée. Pour activer le contact Rôles et autorisations notre [équipe de soutien](https://www.onespan.com/fr/support). Pour obtenir plus d'informations, voir Administrer les utilisateurs. ### Ajout d'utilisateurs Pour ajouter un utilisateur à votre compte, vous devez créer un objet AccountMember . Ensuite, vous pouvez tout sur votre OneSpan Sign AccountService pour envoyer une invitation à l'utilisateur. Une fois qu'un nouvel utilisateur a été invité à rejoindre un compte, il est automatiquement ajouté au compte, mais dans un statut inactif. L'utilisateur recevra un courriel contenant un lien qu'il devra cliquer pour activer son compte. Vous pouvez sauter cette étape de vérification en définissant le statut ACTIF lors de la création de votre objet AccountMember. ```java AccountMember member = AccountMemberBuilder.newAccountMember("john.smith@example.com ") .withFirstName("John") .withLastName("Smith") .withCompany("ABC Bank") .withTitle("CEO") .withStatus(SenderStatus.ACTIVE) .build(); client.getAccountService().inviteUser(member); ``` #### Renvoi d'une invitation à un compte Lorsqu'un utilisateur est invité à rejoindre un compte, il reçoit un courriel qu'il doit utiliser pour activer son compte. L'extrait de code suivant illustre la manière de renvoyer cet courriel. ```java eslClient.getAccountService().sendInvite(retrievedSender.getId()); ``` ### Récupération des utilisateurs La première étape de la délégation d'accès consiste à récupérer une liste d'utilisateurs à partir de votre compte OneSpan Sign, ce qui est décrit dans l'exemple de code suivant. Cette liste comprend les adresses courriel de vos utilisateurs, ainsi que leurs identifiants. Des identifiants sont nécessaires pour ajouter et supprimer des délégués. Le nombre maximum d'utilisateurs que vous pouvez récupérer, tel que défini par cette API, est de 100. Voici un exemple de code qui décrit comment procéder. Dans cet exemple, le nombre d'utilisateurs renvoyés dans la liste est de 5, comme défini par PageRequest. ```java int i = 1; Map accountMembers = client.getAccountService().getSenders(Direction.ASCENDING, new PageRequest(i,5)); while(!accountMembers.isEmpty()) { for (Map.Entry entry : accountMembers.entrySet()) { String email = (String) entry.getKey(); Sender sender = (Sender) entry.getValue(); System.out.println(email + ", " + sender.getId()); i++; } accountMembers =  client.getAccountService().getSenders(Direction.ASCENDING, new PageRequest(i,5)); } ``` ### Mise à jour d'un utilisateur Pour mettre à jour un utilisateur, vous avez besoin de son ID utilisateur. Notez qu'une adresse courriel ne peut pas être mise à jour une fois que vous avez créé votre utilisateur. Pour modifier une adresse courriel, vous devez créer un nouvel utilisateur. ```java SenderInfo updatedSenderInfo = SenderInfoBuilder.newSenderInfo("john.smith@example.com")                .withName( "John", "Smith" )                .withTitle( "CEO" )                .withCompany("XYZ Bank")                .build(); client.getAccountService().updateSender(updatedSenderInfo, "{senderId}"); ``` ### Suppression d'un utilisateur Pour supprimer un utilisateur, vous avez besoin de son ID utilisateur. Voici un exemple de code qui décrit comment procéder. Si votre utilisateur a déjà des transactions dans sa boîte de réception, ou des transactions à le statut d'ébauche , l'utilisateur sera verrouillé au lieu d'être supprimé. Il ne pourra pas créer ou envoyer d'autres transactions. ```java client.getAccountService().deleteSender("{senderId}"); ``` ### Récupération d'un utilisateur spécifique L'exemple de code suivant vous aide à récupérer un utilisateur spécifique d'un compte. ```java Sender retrievedSender = eslClient.getAccountService().getSender("senderId"); ``` ### Envoi d'une transaction en utilisant un expéditeur spécifique L'exemple de code ci-dessous vous montre comment construire une transaction qui sera envoyée par un utilisateur spécifique : ```java DocumentPackage packageToSend = PackageBuilder.newPackageNamed("Cleaning Contract Example") .withSenderInfo(SenderInfoBuilder.newSenderInfo("john.smith@example.com")) .withSigner(SignerBuilder.newSignerWithEmail("mary.doe@example.com") .withFirstName("Mary") .withLastName("Doe") .withCustomId("client")) .withSigner(SignerBuilder.newSignerWithEmail("john.smith@example.com") .withFirstName("John") .withLastName("Smith") .withCustomId("contractor")) .withDocument(DocumentBuilder.newDocumentWithName("Contract.pdf") .fromStream(new FileInputStream("DOC_FILE_PATH"), DocumentType.PDF) .enableExtraction()) .build(); ``` ### Résultats Après avoir exécuté votre code, vous trouverez vos utilisateurs nouvellement créés dans votre compte OneSpan Sign. ![Capture](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/senders_java_1(1).png?sv=2026-02-06&spr=https&st=2026-11-13T10%3A57%3A10Z&se=2026-11-13T11%3A57%3A10Z&sr=c&sp=r&sig=%2BIZfaFBnyJhLkPmsFbCrEFJdq0BnD4nhCyQXF8a%2FeSc%3D) ## .NET SDK Pour télécharger l'exemple complet de code, consultez notre site [Partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/managing-senders-net-sdk/). OneSpan Sign vous offre la possibilité d'ajouter des utilisateurs à votre compte, leur permettant de créer et d'envoyer des transactions pour la signature numérique. En tant que propriétaire du compte, vous aurez accès aux transactions créées par vos utilisateurs. Cependant, vous ne pouvez récupérer ces transactions qu'en utilisant les SDK ou les API. Si vous voulez accéder à ces transactions à l'aide de l'interface Web, vous devrez demander à vos utilisateurs de vous déléguer l'accès. Pour obtenir plus d'informations, voir [Délégation d'accès](/v1/docs/fr/delegating-access#net-sdk). ### Trouver vos utilisateurs dans l'interface utilisateur Tout d'abord, localisez vos expéditeurs dans l'interface Web OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign et cliquez sur Admin > Utilisateurs. Après avoir exécuté votre code, tous vos utilisateurs apparaîtront ici. La page Utilisateurs remplace la page Expéditeurs si l'option Rôles et permissions a été activée. Pour activer le contact Rôles et autorisations notre [équipe de soutien](https://www.onespan.com/fr/support). Pour obtenir plus d'informations, voir Administrer les utilisateurs. ### Ajout d'utilisateurs Pour ajouter un utilisateur à votre compte, vous devez créer un objet AccountMember . Ensuite, vous pouvez tout sur votre OneSpan Sign AccountService pour envoyer une invitation à l'utilisateur. Une fois qu'un nouvel utilisateur a été invité à rejoindre un compte, il est automatiquement ajouté au compte, mais dans un statut inactif. L'utilisateur recevra un courriel contenant un lien qu'il devra cliquer pour activer son compte. Vous pouvez sauter cette étape de vérification en définissant le statut ACTIF lors de la création de votre objet AccountMember. ```csharp AccountMember member = AccountMemberBuilder.NewAccountMember("john.smith@example.com") .WithFirstName("John") .WithLastName("Smith") .WithCompany("ABC Bank") .WithTitle("CEO") .WithStatus(SenderStatus.ACTIVE) .Build(); client.AccountService.InviteUser(member); ``` #### Renvoi d'une invitation à un compte Lorsqu'un utilisateur est invité à rejoindre un compte, il reçoit un courriel qu'il doit utiliser pour activer son compte. L'extrait de code suivant illustre la manière de renvoyer cet courriel. ```plaintext eslClient.AccountService.SendInvite(retrievedSender.Id); ``` ### Récupération des utilisateurs La première étape de la délégation d'accès consiste à récupérer une liste d'utilisateurs à partir de votre compte OneSpan Sign, ce qui est décrit dans l'exemple de code suivant. Cette liste comprend les adresses courriel de vos utilisateurs, ainsi que leurs identifiants. Des identifiants sont nécessaires pour ajouter et supprimer des délégués. Le nombre maximum d'utilisateurs que vous pouvez récupérer, tel que défini par cette API, est de 100. Voici un exemple de code qui décrit comment procéder. Dans cet exemple, le nombre d'utilisateurs renvoyés dans la liste est de 5, comme défini par PageRequest. ```csharp int i = 1; IDictionary accountMembers = client.AccountService.GetSenders(Direction.ASCENDING, new PageRequest(i, 5));        while (accountMembers.Count != 0)        {            foreach (var s in accountMembers)            {                string email = s.Key.ToString();                string id = s.Value.Id;                Debug.WriteLine(email + " " + id);                i++;            }            accountMembers = client.AccountService.GetSenders(Direction.ASCENDING, new PageRequest(i, 5));        } ``` ### Mise à jour d'un utilisateur Pour mettre à jour un utilisateur, vous avez besoin de son ID utilisateur. Notez qu'une adresse courriel ne peut pas être mise à jour une fois que vous avez créé votre utilisateur. Pour modifier une adresse courriel, vous devez créer un nouvel utilisateur. ```csharp SenderInfo updatedSenderInfo = SenderInfoBuilder.NewSenderInfo("john.smith@example.com")                .WithName( "John", "Smith" )                .WithTitle( "CEO" )                .WithCompany("XYZ Bank")                .Build(); client.AccountService.UpdateSender(updatedSenderInfo, "{senderId}"); ``` ### Suppression d'un utilisateur Pour supprimer un utilisateur, vous avez besoin de son ID utilisateur. Voici un exemple de code qui décrit comment procéder. Si votre utilisateur a déjà des transactions dans sa boîte de réception, ou des transactions à le statut d'ébauche , l'utilisateur sera verrouillé au lieu d'être supprimé. Il ne pourra pas créer ou envoyer d'autres transactions. ```csharp client.AccountService.DeleteSender("{senderId}"); ``` ### Récupération d'un utilisateur spécifique L'exemple de code suivant vous aide à récupérer un utilisateur spécifique d'un compte. ```csharp Sender retrievedSender = eslClient.AccountService.GetSender("senderId"); ``` ### Envoi d'une transaction en utilisant un expéditeur spécifique L'exemple de code ci-dessous vous montre comment construire une transaction qui sera envoyée par un utilisateur spécifique : ```csharp DocumentPackage packageToSend = PackageBuilder.NewPackageNamed("Cleaning Contract Example")                .WithSenderInfo(SenderInfoBuilder.NewSenderInfo("john.smith@example.com"))                .WithSigner(SignerBuilder.NewSignerWithEmail("mary.doe@example.com ")                        .WithFirstName("Mary")                        .WithLastName("Doe")                        .WithCustomId("client"))                .WithSigner(SignerBuilder.NewSignerWithEmail("john.smith@example.com")                        .WithFirstName("John")                        .WithLastName("Smith")                        .WithCustomId("contractor"))                .WithDocument(DocumentBuilder.NewDocumentNamed("Contract.pdf")                        .FromStream(new FileStream("DOC_FILE_PATH", FileMode.Open), DocumentType.PDF)                        .EnableExtraction())                .Build(); ``` ### Résultats Après avoir exécuté votre code, vous trouverez vos utilisateurs nouvellement créés dans votre compte OneSpan Sign. ![Capture](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/senders_net_1(1).png?sv=2026-02-06&spr=https&st=2026-11-13T10%3A57%3A10Z&se=2026-11-13T11%3A57%3A10Z&sr=c&sp=r&sig=%2BIZfaFBnyJhLkPmsFbCrEFJdq0BnD4nhCyQXF8a%2FeSc%3D) ## API REST Pour télécharger l'exemple complet de code, consultez notre site [Partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/managing-senders-rest-api). OneSpan Sign vous offre la possibilité d'ajouter des utilisateurs à votre compte, leur permettant de créer et d'envoyer des transactions pour la signature numérique. En tant que propriétaire du compte, vous aurez accès aux transactions créées par vos utilisateurs. Cependant, vous ne pouvez récupérer ces transactions qu'en utilisant les SDK ou les API. Si vous voulez accéder à ces transactions à l'aide de l'interface Web, vous devrez demander à vos utilisateurs de vous déléguer l'accès. Pour obtenir plus d'informations, voir [Délégation d'accès](/v1/docs/fr/delegating-access#api-rest). ### Expéditeurs dans l'IU Tout d'abord, localisez vos expéditeurs dans l'interface Web OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign et cliquez sur Admin > Utilisateurs. Après avoir exécuté votre code, tous vos utilisateurs apparaîtront ici. La page Utilisateurs remplace la page Expéditeurs si l'option Rôles et permissions a été activée. Pour activer le contact Rôles et autorisations notre [équipe de soutien](https://www.onespan.com/fr/support). Pour obtenir plus d'informations, voir Administrer les utilisateurs. ### Ajout d'utilisateurs Pour ajouter un utilisateur à votre compte, utilisez les exemples de code suivants. #### Requête HTTP ```http POST /api/account/senders ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: application/json Authorization: Basic api_key ``` #### Données utiles de la demande ```json { "email" : "john.smith@example.com",   "firstName" : "John",   "lastName" : "Smith",   "company" : "ABC Bank",   "title" : "CEO",   "status" : "ACTIVE"    }   ``` #### Données utiles de la réponse ```json {    "status": "ACTIVE",    "language": "en",    "signature": null,    "id": "gF0JJvbDb2Y0",    "data": {        "hasNotCreatedATransaction": true,        "showIntro": true    },    "account": {        "id": "3vD0Dc9Fh7wQ",        "data": null,        "updated": "2016-05-05T19:30:13Z",        "company": {            "id": "jVWmyg4cyis8",            "data": null,            "address": {                "address1": null,                "address2": null,                "city": null,                "country": null,                "zipcode": null,                "state": null            },            "name": "OneSpan Sign"        },        "licenses": [            {                "status": "ACTIVE",                "paidUntil": "2020-05-05T00:00:00Z",                "plan": {                    "group": "",                    "description": "E-Sign Hundreds of Documents with Unlimited Signers",                    "id": "sandbox",                    "features": null,                    "price": {                        "amount": 0,                        "currency": {                            "id": "USD",                            "data": null,                            "name": "US Dollar"                        }                    },                    "original": null,                    "cycle": "YEAR",                    "contract": "YEAR",                    "freeCycles": null,                    "quotas": [                        {                            "cycle": null,                            "scope": "ACCOUNT",                            "limit": 100,                            "target": "SENDER"                        },                        {                            "cycle": null,                            "scope": "SENDER",                            "limit": 500,                            "target": "DOCUMENT"                        },                        {                            "cycle": null,                            "scope": "SENDER",                            "limit": 500,                            "target": "STORAGE"                        }                    ],                    "data": null,                    "name": "Sandbox"                },                "transactions": [],                "created": "2016-05-05T19:30:13Z"            }        ],        "logoUrl": "",        "providers": null,        "customFields": [            {                "required": false,                "id": "policy_number_id",                "data": null,                "translations": [                    {                        "description": "Car Insurance Policy Number.",                        "language": "en",                        "id": "",                        "data": null,                        "name": "Policy Number"                    }                ],                "value": "123-456-789-0",                "name": ""            }        ],        "created": "2016-05-05T19:30:13Z",        "owner": "ZQI8k6faVoM8",        "name": "Haris Haidary"    },    "title": "CEO",    "external": null,    "updated": "2017-11-20T18:36:02Z",    "memberships": [],    "phone": "",    "professionalIdentityFields": [],    "userCustomFields": [],    "locked": null,    "activated": null,    "company": "ABC Bank",    "email": "john.smith@example.com",    "firstName": "John",    "lastName": "Smith",    "type": "REGULAR",    "name": "",    "address": null,    "created": "2017-11-20T18:36:02Z",    "specialTypes": [],    "hasDelegates": false } ``` #### Renvoi d'une invitation à un compte Lorsqu'un utilisateur est invité à rejoindre un compte, il reçoit un courriel qu'il doit utiliser pour activer son compte. L'extrait de code suivant illustre la manière de renvoyer cet courriel. #### Requête HTTP ```http POST /api/account/senders/{senderUid}/invite ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: application/json Authorization: Basic api_key ``` ### Récupération des utilisateurs Vous pouvez également retrouver vos expéditeurs : #### Requête HTTP ```http GET /api/account/senders?from=0&to=1 ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: application/json Authorization: Basic api_key ``` #### Données utiles de la demande ```json {    "results": [        {            "status": "ACTIVE",            "language": "en",            "signature": null,            "id": "IBCyHvarzWsX",            "data": {                "hasNotCreatedATransaction": true,                "showIntro": true            },            "account": {                "id": "3vD0Dc9Fh7wQ",                "created": "2016-05-05T19:30:13Z",                "data": null,                "company": {                    "id": "jVWmyg4cyis8",                    "data": null,                    "address": {                        "address1": null,                        "address2": null,                        "city": null,                        "country": null,                        "zipcode": null,                        "state": null                    },                    "name": "OneSpan Sign"                },                "updated": "2016-05-05T19:30:13Z",                "licenses": [                    {                        "status": "ACTIVE",                        "transactions": [],                        "created": "2016-05-05T19:30:13Z",                        "paidUntil": "2020-05-05T00:00:00Z",                        "plan": {                            "group": "",                            "description": "E-Sign Hundreds of Documents with Unlimited Signers",                            "id": "sandbox",                            "price": {                                "amount": 0,                                "currency": {                                    "id": "USD",                                    "data": null,                                    "name": "US Dollar"                                }                            },                            "original": null,                            "features": null,                            "data": null,                            "cycle": "YEAR",                            "contract": "YEAR",                            "freeCycles": null,                            "quotas": [                                {                                    "scope": "ACCOUNT",                                    "cycle": null,                                    "limit": 100,                                    "target": "SENDER"                                },                                {                                    "scope": "SENDER",                                    "cycle": null,                                    "limit": 500,                                    "target": "DOCUMENT"                                },                                {                                    "scope": "SENDER",                                    "cycle": null,                                    "limit": 500,                                    "target": "STORAGE"                                }                            ],                            "name": "Sandbox"                        }                    }                ],                "logoUrl": "",                "providers": null,                "customFields": [                    {                        "required": false,                        "id": "policy_number_id",                        "data": null,                        "translations": [                            {                                "description": "Car Insurance Policy Number.",                                "language": "en",                                "id": "",                                "data": null,                                "name": "Policy Number"                            }                        ],                        "value": "123-456-789-0",                        "name": ""                    }                ],                "owner": "ZQI8k6faVoM8",                "name": "Haris Haidary"            },            "title": null,            "activated": null,            "company": "",            "email": "mail73@example.com",            "firstName": "Peter",            "lastName": "Pan",            "external": null,            "updated": "2017-11-13T15:07:49Z",            "memberships": [],            "phone": "",            "professionalIdentityFields": [],            "userCustomFields": [],            "locked": null,            "address": null,            "created": "2017-11-13T15:07:49Z",            "name": "",            "type": "REGULAR",            "specialTypes": [],            "hasDelegates": false        },        {            "status": "ACTIVE",            "language": "en",            "signature": null,            "id": "2q37oSloj5AD",            "data": {                "hasNotCreatedATransaction": true,                "showIntro": true            },            "account": {                "id": "3vD0Dc9Fh7wQ",                "created": "2016-05-05T19:30:13Z",                "data": null,                "company": {                    "id": "jVWmyg4cyis8",                    "data": null,                    "address": {                        "address1": null,                        "address2": null,                        "city": null,                        "country": null,                        "zipcode": null,                        "state": null                    },                    "name": "OneSpan Sign"                },                "updated": "2016-05-05T19:30:13Z",                "licenses": [                    {                        "status": "ACTIVE",                        "transactions": [],                        "created": "2016-05-05T19:30:13Z",                        "paidUntil": "2020-05-05T00:00:00Z",                        "plan": {                            "group": "",                            "description": "E-Sign Hundreds of Documents with Unlimited Signers",                            "id": "sandbox",                            "price": {                                "amount": 0,                                "currency": {                                    "id": "USD",                                    "data": null,                                    "name": "US Dollar"                                }                            },                            "original": null,                            "features": null,                            "data": null,                            "cycle": "YEAR",                            "contract": "YEAR",                            "freeCycles": null,                            "quotas": [                                {                                    "scope": "ACCOUNT",                                    "cycle": null,                                    "limit": 100,                                    "target": "SENDER"                                },                                {                                    "scope": "SENDER",                                    "cycle": null,                                    "limit": 500,                                    "target": "DOCUMENT"                                },                                {                                    "scope": "SENDER",                                    "cycle": null,                                    "limit": 500,                                    "target": "STORAGE"                                }                            ],                            "name": "Sandbox"                        }                    }                ],                "logoUrl": "",                "providers": null,                "customFields": [                    {                        "required": false,                        "id": "policy_number_id",                        "data": null,                        "translations": [                            {                                "description": "Car Insurance Policy Number.",                                "language": "en",                                "id": "",                                "data": null,                                "name": "Policy Number"                            }                        ],                        "value": "123-456-789-0",                        "name": ""                    }                ],                "owner": "ZQI8k6faVoM8",                "name": "Haris Haidary"            },            "title": null,            "activated": null,            "company": "",            "email": "mail72@example.com",            "firstName": "Mike",            "lastName": "Smith",            "external": null,            "updated": "2017-11-13T15:07:49Z",            "memberships": [],            "phone": "",            "professionalIdentityFields": [],            "userCustomFields": [],            "locked": null,            "address": null,            "created": "2017-11-13T15:07:50Z",            "name": "",            "type": "REGULAR",            "specialTypes": [],            "hasDelegates": false        }    ],    "count": 8 } ``` ### Récupération d'un utilisateur spécifique L'exemple de code suivant vous aide à récupérer un utilisateur spécifique d'un compte. #### Requête HTTP ```http GET/api/account/senders/{senderId} ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: application/json Authorization: Basic api_key ``` #### Données utiles de la demande ```json {    "status": "ACTIVE",    "language": "en",    "signature": null,    "id": "IBCyHvarzWsX",    "data": {        "hasNotCreatedATransaction": true,        "showIntro": true    },    "account": {        "id": "3vD0Dc9Fh7wQ",        "data": null,        "updated": "2016-05-05T19:30:13Z",        "company": {            "id": "jVWmyg4cyis8",            "data": null,            "address": {                "address1": null,                "address2": null,                "city": null,                "country": null,                "zipcode": null,                "state": null            },            "name": "OneSpan Sign"        },        "licenses": [            {                "status": "ACTIVE",                "paidUntil": "2020-05-05T00:00:00Z",                "plan": {                    "group": "",                    "description": "E-Sign Hundreds of Documents with Unlimited Signers",                    "id": "sandbox",                    "features": null,                    "price": {                        "amount": 0,                        "currency": {                            "id": "USD",                            "data": null,                            "name": "US Dollar"                        }                    },                    "original": null,                    "cycle": "YEAR",                    "contract": "YEAR",                    "freeCycles": null,                    "quotas": [                        {                            "cycle": null,                            "scope": "ACCOUNT",                            "limit": 100,                            "target": "SENDER"                        },                        {                            "cycle": null,                            "scope": "SENDER",                            "limit": 500,                            "target": "DOCUMENT"                        },                        {                            "cycle": null,                            "scope": "SENDER",                            "limit": 500,                            "target": "STORAGE"                        }                    ],                    "data": null,                    "name": "Sandbox"                },                "transactions": [],                "created": "2016-05-05T19:30:13Z"            }        ],        "logoUrl": "",        "providers": null,        "customFields": [            {                "required": false,                "id": "policy_number_id",                "data": null,                "translations": [                    {                        "description": "Car Insurance Policy Number.",                        "language": "en",                        "id": "",                        "data": null,                        "name": "Policy Number"                    }                ],                "value": "123-456-789-0",                "name": ""            }        ],        "created": "2016-05-05T19:30:13Z",        "owner": "ZQI8k6faVoM8",        "name": "Haris Haidary"    },    "title": "CEO",    "external": null,    "updated": "2017-11-13T15:07:49Z",    "memberships": [],    "phone": "",    "professionalIdentityFields": [],    "userCustomFields": [],    "locked": null,    "activated": null,    "company": "ABC Bank",    "email": "mail73@example.com",    "firstName": "John",    "lastName": "Smith",    "type": "REGULAR",    "name": "",    "address": null,    "created": "2017-11-13T15:07:49Z",    "specialTypes": [],    "hasDelegates": false } ``` ### Mise à jour d'un utilisateur Pour mettre à jour un utilisateur, vous avez besoin de son ID utilisateur. Notez qu'une adresse courriel ne peut pas être mise à jour une fois que vous avez créé votre utilisateur. Pour modifier une adresse courriel, vous devez créer un nouvel utilisateur. #### Requête HTTP ```http POST/api/account/senders/{senderId} ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: application/json Authorization: Basic api_key ``` #### Données utiles de la demande ```json {    "firstName" : "John",    "lastName" : "Smith",    "company" : "XYZ Bank",    "title" : "CEO", } ``` ### Suppression d'un utilisateur Pour supprimer un utilisateur, vous avez besoin de son ID utilisateur. Voici un exemple de code qui décrit comment procéder. Si votre utilisateur a déjà des transactions dans sa boîte de réception, ou des transactions à le statut d'ébauche , l'utilisateur sera verrouillé au lieu d'être supprimé. Il ne pourra pas créer ou envoyer d'autres transactions. #### Requête HTTP ```http DELETE /api/account/senders/{senderId} ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: application/json Authorization: Basic api_key ``` ### Récupérer la clé API d'un expéditeur L'API REST ci-dessous vous montre comment récupérer la clé API de votre expéditeur en utilisant l'autorisation du gestionnaire de compte dans l'en-tête de la demande. #### Requête HTTP ```http GET /api/account/senders/{senderId}/apiKey ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: application/json Authorization: clé_api de base ``` #### Données utiles de la réponse ```json { "apiKey": "XXXXXXXXXXXXX==" } ``` ### Envoi d'une transaction en utilisant un expéditeur spécifique L'exemple de code ci-dessous vous montre comment construire une transaction qui sera envoyée par un utilisateur spécifique : #### Requête HTTP ```http POST /api/packages ``` #### En-têtes HTTP ```http Accept: application/json Content-Type: multipart/form-data Authorization: clé_api de base ``` ### Tableau des données utiles de la demande Pour une description complète de chaque champ, voir ce tableau : | Propriété | Type | Modifiable | Requis | Par défaut | Exemples de valeurs | | --- | --- | --- | --- | --- | --- | | statut | chaîne de caractères | Oui | Non | INVITÉ | ACTIF / INVITÉ / VERROUILLÉ | | courriel | chaîne de caractères | Oui | Non | s.o. | john.smith@exemple.com | | Prénom | chaîne de caractères | Oui | Non | s.o. | John | | Nom de famille | chaîne de caractères | Oui | Non | s.o. | Smith | | entreprise | chaîne de caractères | Oui | Non | s.o. | Banque ABC | | titre | chaîne de caractères | Oui | Non | s.o. | PDG | | phoneNumber | chaîne de caractères | Oui | Non | s.o. | +15256951122 | ```json ------WebKitFormBoundary1bNO60n7FqP5WO4t Content-Disposition: form-data; name="file"; filename="testDocumentExtraction.pdf" Content-Type: application/pdf %PDF-1.5 %µµµµ 1 0 obj <>>> endobj.... ------WebKitFormBoundary1bNO60n7FqP5WO4t Content-Disposition: form-data; name="payload" {  "sender": {    "email": "john.smith@example.com"  },  "documents": [    {      "extract": true,      "name": "Contract"    }  ],  "status": "DRAFT",  "roles": [    {      "id": "contractor",      "type": "SENDER",      "signers": [        {          "email": "john.smith@example.com",          "firstName": "John",          "lastName": "Smith",          "id": "contractor"        }      ],      "name": "contractor"    },    {      "id": "client",      "type": "SIGNER",      "signers": [        {          "email": "mary.doe@example.com",          "firstName": "Mary",          "lastName": "Doe",          "id": "client"        }      ],      "name": "client"    }  ],  "type": "PACKAGE",  "name": "Cleaning Contract Example" } ``` #### Données utiles de la réponse ```json { "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI=" } ```