Dans cette documentation nous allons voir les cas d'utilisation les plus communs pour vous permettre d'intégrer la signature électronique de Docage à votre propre produit. En complément de cette documentation, vous pouvez également aller visiter notre page [Swagger](https://api.docage.com/swagger) pour découvrir toutes les entités et les routes de notre API. #### **Prérequis** La plupart des routes de l'API nécessitent une authentification. Pour rajouter une authentification à votre requête vous devez posséder un compte Docage, que vous pouvez tester gratuitement [ici](https://api.docage.com/Identity/Account/Register). Votre compte sera créé en mode démo, les comptes dans ce mode n'ont pas de date d'expiration et vous sera utile pour tester Docage ainsi que votre intégration de Docage de manière gratuite. Une fois votre compte créé accédez à votre profile utilisateur et sélectionnez l'onglet "Clé d'API" et cliquez sur le bouton de génération de votre clé d'API. Cette clé servira à vous authentifier à notre API, ce qui permettra d'accéder à toutes les données qui vous appartiennent sur notre application, pour cette raison, veuillez garder cette clé de manière personnelle et ne la partagez pas. Nous utilisons [Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication) pour nous authentifier à l'API lors d'appel à celle-ci. Vous devez donc renseigner le **username** qui correspond à votre email d'utilisateur Docage et le **password** qui correspond à votre clé API, séparé par le caractère `:`. **Le tout encodé en base 64**. Exemple de ce à quoi votre header Authorization doit ressembler avec un encodage en base 64 du couple username:apikey. Notez qu'il faut laisser un espave entre Basic et les identifiants encodé en base 64. Le code est présenté pour la compréhension, il est à adapter dans votre language de programmation : ``` javascript let username = "abc@dom.com"; let apikey = "123"; let headers = new Headers(); let encodedCredentials = btoa(username + ":" + apikey); headers.set('Authorization', 'Basic ' + encodedCredentials); ``` #### **Notes** - Si vous souhaitez tester notre API sans écrire de ligne de code dans un premier temps, vous pouvez utiliser [Postman](https://www.postman.com) (ou une application similaire) pour vous familiariser avec les informations que vous envoyez/recevez. - Les DateTime doivent être en format ISO 8601, par exemple "2012-04-23T18:25:43.511Z"

Versori has established itself as the third generation of Integration Platform as a Service (iPaaS). Versori builds custom integrations for its customers using an intuitive visual user interface.

Versori’s connector engine means there is no dependency on an existing library of apps, all you need to start is the documentation of the app or system you want to integrate to.