Selecting the Environment Quick look (the "eye" icon to the right of the environment drop-down) in Postman will enable you to view all your environment variables and confirm you have what is needed to start making DocuSign eSignature API calls.įigure 7: The Postman environment includes four new parameters after completing the authentication calls to DocuSign Making your first DocuSign eSignature API call with Postman That call is used to populate additional environment variables such as your accountId, userId and baseUrl required to make any eSignature API call. This is the last call in the Authentication folder and can be made as soon as you obtain the access token. The next call you have to make is 04 Get User Info. These will be automatically stored in the Postman environment for you.įigure 6: Sending the 01 Authorize Code Grant Access Token request If successful, you should get back an access_token and refresh_token. Hit the Send button at the top of Postman to make the call to DocuSign. If you don’t send this information to DocuSign quickly enough, you will have to obtain a new code again. Note that the code is valid for two minutes only. To start the authentication process, you have to manually construct a URL that looks like this: You may also use JWT (JSON Web Tokens) if you prefer. These steps show you how to use Authorization Code Grant to obtain an access token to make your API calls from postman. Your app should look like figure 4.įigure 4: Postman after DocuSign eSignature REST API import Running the authentication codeīefore you proceed, make sure to select DocuSign-account-d (since you selected demo when setting the environment, it will be a different name for production) from the environment dropdown at the top-right corner of the Postman window (next to the "eye" icon) to ensure the environment information you created earlier is applied to the variables inside the calls. Optional on Windows: Another security popup (see figure 3) may require you to select Open Postman before the application launches.įigure 2: Launching the Postman application from the websiteįigure 3: Additional security popup on Windows before launching the application Using Postman to make DocuSign eSignature API callsĪfter you follow the preceding steps and configure DocuSign in Postman, you are ready to start using it.Select Postman for Windows to run the Postman client application. On Windows, a small popup window will appear (figure 2).You can leave the Environment ( Demo, which is the developer environment and what we will discuss in this blog post) and API version default settings.įigure 1: Configuring the initial environment to be used with the DocuSign eSignature Postman collection Configuring Postman continued:.Select SET UP YOUR ENVIRONMENT. The dialog box shown in figure 1 appears and prompts you to enter your integration key and corresponding secret key which you created in step 2 above.Navigate to the DocuSign eSignature API Postman Collection page.We recommend you use something like “ (I’ll explain later how you use this). You will also have to add at least one URL in the redirectUri list for this integration key. Create a new integration key and secret key in the DocuSign Apps and Keys page inside the DocuSign Settings application (Take a note of the secret key, as you can only see it once when you create it).If you don’t have one, you can create one for free. Make sure you have a DocuSign developer account and integration key.To configure Postman for the DocuSign collections, follow these steps: Configuration is a one-time process that imports the DocuSign API and creates an environment with your API credentials so you can easily execute calls. Setting up your personalized Postman configurationīefore you can use Postman with the DocuSign eSignature REST API, you need to configure it. Once it's installed, you can launch the application directly if you want to try it out, but to use it with the DocuSign collections, you need to personalize it with your own information. It is available for Linux, macOS, or Windows. To use the collections, you must first install the Postman app on your computer. How to use the DocuSign eSignature Postman collection Watch a YouTube video showcasing how to use the DocuSign Postman collections. Full list of 366 different requests covering every endpoint of the eSignature REST API.Support for modern, secure OAuth 2.0 authentication.Support for version 2.1 of the DocuSign eSignature API.The DocuSign public Postman collections were recently named among the top 10 Postman API Workspaces as picked by Postman staff. The Marvelletes have been waiting for the postman, but here at the DocuSign API team, we have no time to wait.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |