{"_id":"56e83d108e380a2000b7ece2","user":"56267741db1eda0d001c3dbb","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":33,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"parentDoc":null,"project":"55faeacad0e22017005b8265","__v":32,"category":{"_id":"561d4c78281aec0d00eb27b6","pages":["561d4ce96386060d00e0600c","561d4d3a6386060d00e0600e","561d4d7431d9630d001eb5c5","56268a0cc2781f0d00364bba","56269097c2781f0d00364bd1","562697d0e2ce610d004e3da8","565f63c3bca87d0d006bc729","5662003255e4450d00e62c9b","566200df36398e0d00f79623","5667219ff672550d00085220","5671be061b6b730d008b4893","56cce1f7ca43550b002814d9","56d743f43513421d0093431b","56d760a6693ef41d0003abe2","56ddf7f52793543200cdc9d5","56df11f85469d02000534e56","56e1bc4c150ed52d0062c66d","56e1bd57a2494b34007f2e57","56e6daeacec7530e006a70e9","56e703e6cb97fd200068ecf2","56e82b56130a993400a647ed","56e83d108e380a2000b7ece2"],"project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","__v":22,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-13T18:24:56.657Z","from_sync":false,"order":0,"slug":"getting-started","title":"Getting Started"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-15T16:49:20.833Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"The Postman client lets you test API requests and create collections of frequently-used requests. \n\nWe've created several Postman collections that let you test out GBDX, GBDX AnswerFactory, and GBDX Vector API requests and see the results.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"One Postman Environment for all collections\",\n  \"body\": \"To use Postman, you'll download one environment where you can run all collections. You'll enter your GBDX username, password, and API key as environment variables.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"1. Get the Postman Files from Github\"\n}\n[/block]\n## GBDX Postman Environment and Collection\nThis collection covers GBDX Authentication, Catalog, Ordering,Task and Workflow APIs, and more. **If you don't need the GBDX Collection, you can skip this step.**\n\n1. Download GBDX Postman files from <a href=\"https://github.com/TDG-Platform/postman\" target=\"_blank\">GBDX Github location</a>\n\n2. Click \"Download zip\". You'll find it above the file list. It will save a zip file called Postman_Master to your local machine.\n\n3. Find the zip file on your local machine and unzip it.\n\n4. Open the Postman_Master file and check to make sure the following files are there. You'll need them when you set up Postman.\n\n* Environment file: GBDX.postman_environment\n* Collection file: GBDX.json.postman_collection\n\n## GBDX Vector Postman Collection\n\nThe GBDX Vector Postman Collection is in a separate Github location. **If you don't need the GBDX Vector Collection, you can skip this step.**\n\n1. Download GBDX Vector Postman files from <a href=\"https://github.com/DigitalGlobe/Postman\" target=\"_blank\">GBDX Vector Github location</a>\n\n2. Click \"Download zip\".  It will save a zip file called Postman_Master to your local machine.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"You may either automatically download files or you may need to choose the file name and file location each time.\\n* If you automatically download files to a location, downloading both collections will result in a file name iteration (ie postman-master.zip and postman-master (1).zip)\\n* If your download settings require you to choose file name and location each time, you will need to rename one of the zip files if you download both collections. For example, call rename the file to Postman_Vector_Master.\",\n  \"title\": \"Depending on your download settings\"\n}\n[/block]\n3. Save the file to your local drive and unzip it.\n\n4. Open the master file. You may have to open additional folders to get to the collection file. For example,\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Ya6PDuwXRcKaizMiLb3A_Postman_vector.PNG\",\n        \"Postman_vector.PNG\",\n        \"608\",\n        \"132\",\n        \"#925f72\",\n        \"\"\n      ],\n      \"sizing\": \"80\"\n    }\n  ]\n}\n[/block]\nCheck to make sure this collection file is there:\n\n* Collection file: GBDXVector.postman_collection.json\n\n*Note: If you did not dowload the GBDX environment file from the GBDX Github location, you can download it from here.*\n\n## GBDX AnswerFactory Postman Collection\n\nThe GBDX AnswerFactory Postman Collection is in the same Github location as the GBDX Vector Collection. **If you don't need the GBDX AnswerFactory Collection, you can skip this step.**\n\n1. Download GBDX AnswerFactory Postman files from <a href=\"https://github.com/DigitalGlobe/Postman\" target=\"_blank\">GBDX AnswerFactory Github location</a>\n\n2. Click \"Download zip\".  It will save a zip file called Postman_Master to your local machine.\n\n3. Save the file to your local drive and unzip it.\n\n4. Open the master file. You may have to open additional folders to get to the collection file.\n\nCheck to make sure this collection file is there:\n\n* Collection file: GBDXAnswerFactory.postman_collection.json\n\n*Note: If you did not dowload the GBDX environment file from the GBDX Github location, you can download it from here.*\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"2. Install Postman\"\n}\n[/block]\nThese instructions apply to the free version of Postman for Chrome. If you install a desktop version or Postman Pro, the setup may be different. \n\n Get postman: <a href=\"http://getpostman.com\" target=\"_blank\">Get Postman</a>\n\nChoose the application you want to install, such as Postman for Chrome. If you need help installing Postman, see <a href=\"http://www.getpostman.com/docs/\" target=\"_blank\">Postman User Documentation</a>\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"3. Set up the GBDX Environment\"\n}\n[/block]\n* Import the GBDX environment variables file. \n\nTo do this, select the environment pull down menu, and choose \"manage environments\".\n\nEnvironment setup uses the controls in the top right corner of the application. \n\nFrom the \"settings\" menu, choose \"Manage Environments\".\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/64ad173-Screen_Shot_2017-04-06_at_1.40.49_PM.png\",\n        \"Screen Shot 2017-04-06 at 1.40.49 PM.png\",\n        404,\n        151,\n        \"#f6f6f6\"\n      ]\n    }\n  ]\n}\n[/block]\n*  From the \"manage environments menu, select \"import\".\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/72143fa-Screen_Shot_2017-04-06_at_1.44.11_PM.png\",\n        \"Screen Shot 2017-04-06 at 1.44.11 PM.png\",\n        369,\n        66,\n        \"#f2f2f2\"\n      ]\n    }\n  ]\n}\n[/block]\n* Select \"choose files\".\n\nNavigate to the file location where you saved the Postman files and select the file \"GBDX.postman_environment\" and open it. You'll get an \"import successful\" message.\n\n* Add environment variables\nOnce you've imported the GBDX environment, it will show up in the \"manage environments\" list. Click on the name \"GBDX\" to add your environment variables. \n\nTo edit these variables later, choose the settings icon, and then \"manage environments\" again. \n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/IR5HVmAdQhegtBPAIksh_environment%20variables.PNG\",\n        \"environment variables.PNG\",\n        \"546\",\n        \"295\",\n        \"#669dd5\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n* Choose GBDX from the dropdown menu\n\nMake sure the dropdown menu in the top right corner shows \"GBDX\". If it says \"no environment\" or shows a different name, choose GBDX from the dropdown menu.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/6FuAB5U7S1YR7Dj0fNcG_postman_gbdx-dropdown.PNG\",\n        \"postman_gbdx-dropdown.PNG\",\n        \"215\",\n        \"46\",\n        \"#9b98a0\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"4. Import the Postman Collections\"\n}\n[/block]\nTo import the Collections, choose \"import\" from the top of the screen.\n\n1. To import the GBDX collection, select \"Choose Files\", then navigate to the file location where you saved the file \"GBDX.json.postman_collection\" and select it.\n\n2. To import the GBDX Vector collection, repeat the process, navigating to the file location where you saved the \"GBDXVector.postman_collection.json\" and select it.\n\n3. To import the GBDX AnswerFactory collection, repeat the process, nagivating to the file location where you saved the \"GBDXAnswerFactory.postman_collection.json\" and select it.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"\",\n  \"title\": \"In the Postman Collections tab, you will see three collections: GBDX, GBDX AnswerFactory, and GBDX Vector.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"5. Get a Token\"\n}\n[/block]\n Before you can start making API requests using Postman, you need to get your Bearer Token (also referred to as an OAuth2 Token). If you've filled in your environment variables, you can use Postman to get your token.\n\n* On the left hand side under Collections, click \"GBDX,\" \"GBDX AnswerFactory,\" or \"GBDX Vector.\" You'll see a list of files. Under \"Auth\" select the Post \"Get User Token\".\n\nSince you've already added your environment variables, you don't need to fill in the values here. Click Send.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"If you did not fill in the environment variables in the earlier step, you can fill them in here instead.\",\n  \"body\": \"Username and password are under \\\"body\\\", and API key is under \\\"Headers\\\".\"\n}\n[/block]\nThe response body to the request will include the token. This token is valid for seven days. You can either add your token to the environment variables, or use it in each request by adding to the Headers section. Remove {{AccesToken}}, and replace it with your token.\n\nNote: If you get an authorization error when trying to run requests in Postman, your token may have expired. Request a new token and update it in the environment variables.","excerpt":"","slug":"postman-instructions-collections","type":"basic","title":"Postman Instructions & Collections"}

Postman Instructions & Collections


The Postman client lets you test API requests and create collections of frequently-used requests. We've created several Postman collections that let you test out GBDX, GBDX AnswerFactory, and GBDX Vector API requests and see the results. [block:callout] { "type": "info", "title": "One Postman Environment for all collections", "body": "To use Postman, you'll download one environment where you can run all collections. You'll enter your GBDX username, password, and API key as environment variables." } [/block] [block:api-header] { "type": "basic", "title": "1. Get the Postman Files from Github" } [/block] ## GBDX Postman Environment and Collection This collection covers GBDX Authentication, Catalog, Ordering,Task and Workflow APIs, and more. **If you don't need the GBDX Collection, you can skip this step.** 1. Download GBDX Postman files from <a href="https://github.com/TDG-Platform/postman" target="_blank">GBDX Github location</a> 2. Click "Download zip". You'll find it above the file list. It will save a zip file called Postman_Master to your local machine. 3. Find the zip file on your local machine and unzip it. 4. Open the Postman_Master file and check to make sure the following files are there. You'll need them when you set up Postman. * Environment file: GBDX.postman_environment * Collection file: GBDX.json.postman_collection ## GBDX Vector Postman Collection The GBDX Vector Postman Collection is in a separate Github location. **If you don't need the GBDX Vector Collection, you can skip this step.** 1. Download GBDX Vector Postman files from <a href="https://github.com/DigitalGlobe/Postman" target="_blank">GBDX Vector Github location</a> 2. Click "Download zip". It will save a zip file called Postman_Master to your local machine. [block:callout] { "type": "warning", "body": "You may either automatically download files or you may need to choose the file name and file location each time.\n* If you automatically download files to a location, downloading both collections will result in a file name iteration (ie postman-master.zip and postman-master (1).zip)\n* If your download settings require you to choose file name and location each time, you will need to rename one of the zip files if you download both collections. For example, call rename the file to Postman_Vector_Master.", "title": "Depending on your download settings" } [/block] 3. Save the file to your local drive and unzip it. 4. Open the master file. You may have to open additional folders to get to the collection file. For example, [block:image] { "images": [ { "image": [ "https://files.readme.io/Ya6PDuwXRcKaizMiLb3A_Postman_vector.PNG", "Postman_vector.PNG", "608", "132", "#925f72", "" ], "sizing": "80" } ] } [/block] Check to make sure this collection file is there: * Collection file: GBDXVector.postman_collection.json *Note: If you did not dowload the GBDX environment file from the GBDX Github location, you can download it from here.* ## GBDX AnswerFactory Postman Collection The GBDX AnswerFactory Postman Collection is in the same Github location as the GBDX Vector Collection. **If you don't need the GBDX AnswerFactory Collection, you can skip this step.** 1. Download GBDX AnswerFactory Postman files from <a href="https://github.com/DigitalGlobe/Postman" target="_blank">GBDX AnswerFactory Github location</a> 2. Click "Download zip". It will save a zip file called Postman_Master to your local machine. 3. Save the file to your local drive and unzip it. 4. Open the master file. You may have to open additional folders to get to the collection file. Check to make sure this collection file is there: * Collection file: GBDXAnswerFactory.postman_collection.json *Note: If you did not dowload the GBDX environment file from the GBDX Github location, you can download it from here.* [block:api-header] { "type": "basic", "title": "2. Install Postman" } [/block] These instructions apply to the free version of Postman for Chrome. If you install a desktop version or Postman Pro, the setup may be different. Get postman: <a href="http://getpostman.com" target="_blank">Get Postman</a> Choose the application you want to install, such as Postman for Chrome. If you need help installing Postman, see <a href="http://www.getpostman.com/docs/" target="_blank">Postman User Documentation</a> [block:api-header] { "type": "basic", "title": "3. Set up the GBDX Environment" } [/block] * Import the GBDX environment variables file. To do this, select the environment pull down menu, and choose "manage environments". Environment setup uses the controls in the top right corner of the application. From the "settings" menu, choose "Manage Environments". [block:image] { "images": [ { "image": [ "https://files.readme.io/64ad173-Screen_Shot_2017-04-06_at_1.40.49_PM.png", "Screen Shot 2017-04-06 at 1.40.49 PM.png", 404, 151, "#f6f6f6" ] } ] } [/block] * From the "manage environments menu, select "import". [block:image] { "images": [ { "image": [ "https://files.readme.io/72143fa-Screen_Shot_2017-04-06_at_1.44.11_PM.png", "Screen Shot 2017-04-06 at 1.44.11 PM.png", 369, 66, "#f2f2f2" ] } ] } [/block] * Select "choose files". Navigate to the file location where you saved the Postman files and select the file "GBDX.postman_environment" and open it. You'll get an "import successful" message. * Add environment variables Once you've imported the GBDX environment, it will show up in the "manage environments" list. Click on the name "GBDX" to add your environment variables. To edit these variables later, choose the settings icon, and then "manage environments" again. [block:image] { "images": [ { "image": [ "https://files.readme.io/IR5HVmAdQhegtBPAIksh_environment%20variables.PNG", "environment variables.PNG", "546", "295", "#669dd5", "" ] } ] } [/block] * Choose GBDX from the dropdown menu Make sure the dropdown menu in the top right corner shows "GBDX". If it says "no environment" or shows a different name, choose GBDX from the dropdown menu. [block:image] { "images": [ { "image": [ "https://files.readme.io/6FuAB5U7S1YR7Dj0fNcG_postman_gbdx-dropdown.PNG", "postman_gbdx-dropdown.PNG", "215", "46", "#9b98a0", "" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "4. Import the Postman Collections" } [/block] To import the Collections, choose "import" from the top of the screen. 1. To import the GBDX collection, select "Choose Files", then navigate to the file location where you saved the file "GBDX.json.postman_collection" and select it. 2. To import the GBDX Vector collection, repeat the process, navigating to the file location where you saved the "GBDXVector.postman_collection.json" and select it. 3. To import the GBDX AnswerFactory collection, repeat the process, nagivating to the file location where you saved the "GBDXAnswerFactory.postman_collection.json" and select it. [block:callout] { "type": "success", "body": "", "title": "In the Postman Collections tab, you will see three collections: GBDX, GBDX AnswerFactory, and GBDX Vector." } [/block] [block:api-header] { "type": "basic", "title": "5. Get a Token" } [/block] Before you can start making API requests using Postman, you need to get your Bearer Token (also referred to as an OAuth2 Token). If you've filled in your environment variables, you can use Postman to get your token. * On the left hand side under Collections, click "GBDX," "GBDX AnswerFactory," or "GBDX Vector." You'll see a list of files. Under "Auth" select the Post "Get User Token". Since you've already added your environment variables, you don't need to fill in the values here. Click Send. [block:callout] { "type": "info", "title": "If you did not fill in the environment variables in the earlier step, you can fill them in here instead.", "body": "Username and password are under \"body\", and API key is under \"Headers\"." } [/block] The response body to the request will include the token. This token is valid for seven days. You can either add your token to the environment variables, or use it in each request by adding to the Headers section. Remove {{AccesToken}}, and replace it with your token. Note: If you get an authorization error when trying to run requests in Postman, your token may have expired. Request a new token and update it in the environment variables.