{"version":"https:\/\/jsonfeed.org\/version\/1","title":"Postman Configuration Tutorial > Docman Help","home_page_url":"https:\/\/help.docman.com\/knowledge-base\/postman-configuration-tutorial\/","feed_url":"https:\/\/help.docman.com\/knowledge-base\/postman-configuration-tutorial\/feed\/json","author":{"name":"nextSTL","url":"https:\/\/help.docman.com"},"items":[{"title":"Postman Configuration Tutorial","date_published":"2018-06-21T13:38:54Z","date_modified":"2018-08-16T09:36:52Z","id":"https:\/\/help.docman.com\/knowledge-base\/postman-configuration-tutorial\/","url":"https:\/\/help.docman.com\/knowledge-base\/postman-configuration-tutorial\/","author":{"name":"Oliver Edwards","url":"","avatar":"https:\/\/secure.gravatar.com\/avatar\/916760a3861c94b0f12d9658070815ac6150c9ba5291c9b5304733d70e0fdb9e?s=96&d=mm&r=g"},"summary":"Introduction\r\nThis article describes how to run the Docman API collection in the postman desktop client.\r\n\r\nPostman is an API development tool that makes sending and receiving web requests to a REST API easy! Use postman to test and learn the Docman \u2026","content_html":"<h1>Introduction<\/h1>\r\nThis article describes how to run the Docman API collection in the <a href=\"https:\/\/www.getpostman.com\/\" target=\"_blank\" rel=\"noopener\">postman<\/a> desktop client.\r\n\r\nPostman is an API development tool that makes sending and receiving web requests to a REST API easy! Use postman to test and learn the Docman API before implementing any code.\r\n<h1>Run in Postman tutorial<\/h1>\r\nThe tutorial starts on the Docman API online documentation page.\r\n\r\nClick on \"Run in Postman\" button\r\n\r\n<img class=\"alignnone size-large wp-image-4055\" src=\"https:\/\/help.docman.com\/wp-content\/uploads\/2018\/06\/postman1-1024x153.png\" alt=\"\" width=\"643\" height=\"96\" \/>\r\n\r\nA new page will open. \"Click Postman for Windows\" to run postman in the native postman desktop application. Make sure you have already installed the postman application and if not click <a href=\"https:\/\/www.getpostman.com\/apps\" target=\"_blank\" rel=\"noopener\">here<\/a> to download and install.\r\n\r\n<img class=\"alignnone size-full wp-image-4056\" src=\"https:\/\/help.docman.com\/wp-content\/uploads\/2018\/06\/postman2.png\" alt=\"\" width=\"394\" height=\"273\" \/>\r\n\r\n&nbsp;\r\n\r\n[ht_message mstyle=\"alert\" title=\"Postman Chrome\" \" show_icon=\"\" id=\"\" class=\"\" style=\"\" ]Postman as a Google Chrome app is now being phased out and not supported by Docman[\/ht_message]\r\n\r\nIn chrome an alert might show up to set a default app for opening postman links. Click on \"Open Postman\".\r\n\r\n<img class=\"alignnone size-full wp-image-4057\" src=\"https:\/\/help.docman.com\/wp-content\/uploads\/2018\/06\/postman3.png\" alt=\"\" width=\"444\" height=\"130\" \/>\r\n\r\nThe Docman API collection will be imported into the postman application as new collection named \"Docman API\".\r\n\r\n<img class=\"alignnone size-large wp-image-4058\" src=\"https:\/\/help.docman.com\/wp-content\/uploads\/2018\/06\/postman4-1024x645.png\" alt=\"\" width=\"643\" height=\"405\" \/>\r\n\r\nTo make it easy Docman have set up a sandpit environment to test the Docman API against. This is also configured as a postman\u00a0<a tabindex=\"-1\" title=\"https:\/\/www.getpostman.com\/docs\/v6\/postman\/environments_and_globals\/manage_environments\" href=\"https:\/\/www.getpostman.com\/docs\/v6\/postman\/environments_and_globals\/manage_environments\" target=\"_blank\" rel=\"noreferrer noopener\">environment<\/a>, all web requests in the Docman API collection reference variables in the postman environment named \u201cDocman Public Sandpit\u201d.\r\n\r\n<strong>Note:\u00a0<\/strong><em>The variable values are\u00a0<strong>blank\u00a0<\/strong>to start with and you need to modify some of them with details provided by Docman such as API username and password.<\/em>\r\n\r\nTo edit the variables, continue to follow this tutorial. Alternatively, edit the variables in each call in the Docman API collection.\r\n\r\nTo edit the variables, continue to follow this tutorial. Alternatively, edit the variables in each call in the Docman API collection.\r\n\r\nClick the cog icon in the top right of the postman application.\r\n\r\n<img class=\"alignnone size-full wp-image-4059\" src=\"https:\/\/help.docman.com\/wp-content\/uploads\/2018\/06\/postman5.png\" alt=\"\" width=\"710\" height=\"596\" \/>\r\n\r\nClick \"Docman Public Sandpit\".\r\n\r\n<img class=\"alignnone wp-image-4082 size-full\" src=\"https:\/\/help.docman.com\/wp-content\/uploads\/2018\/06\/postman_enviroment.png\" alt=\"\" width=\"712\" height=\"693\" \/>\r\n\r\n&nbsp;\r\n\r\nModifiy the values using the table as guidance and click \"update\".\r\n\r\n[su_table]\r\n<table>\r\n<tbody>\r\n<tr>\r\n<td>Value<\/td>\r\n<td>Description<\/td>\r\n<td>Required<\/td>\r\n<\/tr>\r\n<tr>\r\n<td>ENV_HOST<\/td>\r\n<td>URL of API, this will be provided to you by Docman<\/td>\r\n<td>Yes<\/td>\r\n<\/tr>\r\n<tr>\r\n<td>ENV_HOST_PORT<\/td>\r\n<td>Either HTTP or HTTPS<\/td>\r\n<td>Yes<\/td>\r\n<\/tr>\r\n<tr>\r\n<td>ENV_USERNMAE<\/td>\r\n<td>Unique username supplied to you by Docman.<\/td>\r\n<td>Yes<\/td>\r\n<\/tr>\r\n<tr>\r\n<td>ENV_PASSWORD<\/td>\r\n<td>Unique password supplied to you by Docman.<\/td>\r\n<td>Yes<\/td>\r\n<\/tr>\r\n<tr>\r\n<td>ENV_ODSCODE<\/td>\r\n<td>Organisation OdsCode you are trying to send and receive documents for<\/td>\r\n<td>Yes<\/td>\r\n<\/tr>\r\n<tr>\r\n<td>ENV_PATIENT_ID<\/td>\r\n<td>NHS Number of patient you are trying to interact with<\/td>\r\n<td>No<\/td>\r\n<\/tr>\r\n<tr>\r\n<td>ENV_DOCUMENT_GUID<\/td>\r\n<td>Document guids are used in the web request and this value can be modified at runtime.<\/td>\r\n<td>No<\/td>\r\n<\/tr>\r\n<\/tbody>\r\n<\/table>\r\n[\/su_table]\r\n<h1>Using Docman API in Postman<\/h1>\r\n&nbsp;","tags":[]}]}