Import GoodData OpenAPI schema to Postman API Platform

It is heavily recommended to use the Postman API Platform for communication with GoodData API (of course if you do now want to communicate with GoodData API directly from code). In this post, I will explain how to import GoodData Open API schema to the Postman API Platform.

Prerequisite

You should have installed Postman API Platform on your computer. 

Step 1: Copy GoodData Open API schema URL

https://www.gooddata.com/developers/cloud-native/doc/hosted/api-and-sdk/api/gooddata-cn-oapi-all-raw-schema.json

Step 2: Open Postman API Platform and import GoodData API schema

Click the Import button in the left top corner:

Click the Link tab and paste there the URL from the Step 1 and click the Continue button:

Show advanced settings be sure that Folder organization is set to Tags:

Click the Import button:

GoodData Open API schema is successfully imported! 🎉🎉🎉

Step 3: Set up API Token and GoodData URL

Open OpenAPI definition and click the Authorization tab:

Select the Bearer Token:

Put your API Token to the field:

If you do not have API Token, or you do not know how to get one, please check the documentation.

Click the Variables tab and set baseUrl that points to your GoodData domain:

In my case it is https://apricot-cobra.trial.cloud.gooddata.com but you will have probably a different one.

Click the Save button:

The Postman API Platform is set up to call GoodData API. You can start to call all endpoints! 🎉🎉🎉

Step 4: Test GoodData API endpoint

Open layout call, for example, the first endpoint and you should see Status: 200 OK:

Pre-request Script 

If you want to modify some part of a request (for example, URI) you can do it with the so-called Pre-request Script in the Postman API Platform.

Let’s say that you want to call two endpoints  /api/v1/layout/workspaces/:workspaceId and /api/v1/layout/workspaces/:workspaceId/analyticsModel. You can manually write edit URI, specifically :workspaceId, in the Postman API Platform but every time you will want to change :workspaceId, you will need to update it everywhere which is not very good experience. Thanks to Pre-request Script, you can write the following script:

const workspaceId = "<workspace-id>";

if (pm.request.url.path.some(":workspaceId")) {
    pm.request.url.path = pm.request.url.path.map(
        (value) => value === ":workspaceId" ? workspaceId : value
    );
}

With the script, you can open Pre-request Script, put it here and click the Save button:

Now, you can call every request where is :workspaceId and you will not need to modify it manually which saves you a lot of time! 🎉🎉🎉

If you want to learn more about Pre-request Script, please check the Postman API Platform docs.