Chilkat Online Tools

TCL / Postman API / Get linked relations

Back to Collection Items

load ./chilkat.dll

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

set http [new_CkHttp]

CkHttp_SetRequestHeader $http "X-API-Key" "{{postman_api_key}}"

set sbResponseBody [new_CkStringBuilder]

set success [CkHttp_QuickGetSb $http "https://api.getpostman.com/apis/{{apiId}}/versions/{{apiVersionId}}/relations" $sbResponseBody]
if {$success == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkStringBuilder $sbResponseBody
    exit
}

set jResp [new_CkJsonObject]

CkJsonObject_LoadSb $jResp $sbResponseBody
CkJsonObject_put_EmitCompact $jResp 0

puts "Response Body:"
puts [CkJsonObject_emit $jResp]

set respStatusCode [CkHttp_get_LastStatus $http]
puts "Response Status Code = $respStatusCode"
if {$respStatusCode >= 400} then {
    puts "Response Header:"
    puts [CkHttp_lastHeader $http]
    puts "Failed."
    delete_CkHttp $http
    delete_CkStringBuilder $sbResponseBody
    delete_CkJsonObject $jResp
    exit
}

# Sample JSON response:
# (Sample code for parsing the JSON response is shown below)

# {
#   "relations": {
#     "contracttest": {
#       "2a9b8fa8-88b7-4b86-8372-8e3f6f6e07f2": {
#         "id": "2a9b8fa8-88b7-4b86-8372-8e3f6f6e07f2",
#         "name": "C test",
#         "updatedAt": "2019-08-29T10:18:11.000Z"
#       }
#     },
#     "integrationtest": {
#       "521b0486-ab91-4d3a-9189-43c9380a0533": {
#         "id": "521b0486-ab91-4d3a-9189-43c9380a0533",
#         "name": "C1",
#         "updatedAt": "2019-08-29T11:40:39.000Z"
#       },
#       "a236b715-e682-460b-97b6-c1db24f7612e": {
#         "id": "a236b715-e682-460b-97b6-c1db24f7612e",
#         "name": "C test",
#         "updatedAt": "2019-08-29T10:18:11.000Z"
#       }
#     },
#     "mock": {
#       "4ccd755f-2c80-481b-a262-49b55e12f5e1": {
#         "id": "4ccd755f-2c80-481b-a262-49b55e12f5e1",
#         "name": "Mock",
#         "url": "https://4ccd755f-2c80-481b-a262-49b55e12f5e1.mock-beta.pstmn.io",
#         "updatedAt": "2019-08-20T10:18:13.000Z"
#       }
#     }
#   }
# }

# Sample code for parsing the JSON response...
# Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

set Id [CkJsonObject_stringOf $jResp "relations.contracttest.2a9b8fa8-88b7-4b86-8372-8e3f6f6e07f2.id"]
set Name [CkJsonObject_stringOf $jResp "relations.contracttest.2a9b8fa8-88b7-4b86-8372-8e3f6f6e07f2.name"]
set UpdatedAt [CkJsonObject_stringOf $jResp "relations.contracttest.2a9b8fa8-88b7-4b86-8372-8e3f6f6e07f2.updatedAt"]
set v_521b0486_ab91_4d3a_9189_43c9380a0533Id [CkJsonObject_stringOf $jResp "relations.integrationtest.521b0486-ab91-4d3a-9189-43c9380a0533.id"]
set v_521b0486_ab91_4d3a_9189_43c9380a0533Name [CkJsonObject_stringOf $jResp "relations.integrationtest.521b0486-ab91-4d3a-9189-43c9380a0533.name"]
set v_521b0486_ab91_4d3a_9189_43c9380a0533UpdatedAt [CkJsonObject_stringOf $jResp "relations.integrationtest.521b0486-ab91-4d3a-9189-43c9380a0533.updatedAt"]
set A236b715_e682_460b_97b6_c1db24f7612eId [CkJsonObject_stringOf $jResp "relations.integrationtest.a236b715-e682-460b-97b6-c1db24f7612e.id"]
set A236b715_e682_460b_97b6_c1db24f7612eName [CkJsonObject_stringOf $jResp "relations.integrationtest.a236b715-e682-460b-97b6-c1db24f7612e.name"]
set A236b715_e682_460b_97b6_c1db24f7612eUpdatedAt [CkJsonObject_stringOf $jResp "relations.integrationtest.a236b715-e682-460b-97b6-c1db24f7612e.updatedAt"]
set v_4ccd755f_2c80_481b_a262_49b55e12f5e1Id [CkJsonObject_stringOf $jResp "relations.mock.4ccd755f-2c80-481b-a262-49b55e12f5e1.id"]
set v_4ccd755f_2c80_481b_a262_49b55e12f5e1Name [CkJsonObject_stringOf $jResp "relations.mock.4ccd755f-2c80-481b-a262-49b55e12f5e1.name"]
set v_Url [CkJsonObject_stringOf $jResp "relations.mock.4ccd755f-2c80-481b-a262-49b55e12f5e1.url"]
set v_4ccd755f_2c80_481b_a262_49b55e12f5e1UpdatedAt [CkJsonObject_stringOf $jResp "relations.mock.4ccd755f-2c80-481b-a262-49b55e12f5e1.updatedAt"]

delete_CkHttp $http
delete_CkStringBuilder $sbResponseBody
delete_CkJsonObject $jResp

Curl Command

curl -X GET
	-H "X-API-Key: {{postman_api_key}}"
https://api.getpostman.com/apis/{{apiId}}/versions/{{apiVersionId}}/relations

Postman Collection Item JSON

{
  "name": "Get linked relations",
  "request": {
    "method": "GET",
    "header": [
    ],
    "url": {
      "raw": "https://api.getpostman.com/apis/{{apiId}}/versions/{{apiVersionId}}/relations",
      "protocol": "https",
      "host": [
        "api",
        "getpostman",
        "com"
      ],
      "path": [
        "apis",
        "{{apiId}}",
        "versions",
        "{{apiVersionId}}",
        "relations"
      ]
    },
    "description": "This call fetches all the relations which are linked to the specified API version along with their details.\n\nThe response will contain a `relations` object which lists all the relation types which are linked to the API version. Each of the relation type will be an object which details the relations of this type. \n\n> Requires <a href=\"#authentication\">API Key</a> as `X-Api-Key` request header or `apikey` URL query parameter."
  },
  "response": [
    {
      "name": "Get linked relations for an API version",
      "originalRequest": {
        "method": "GET",
        "header": [
        ],
        "url": {
          "raw": "https://api.getpostman.com/apis/{{apiId}}/versions/{{apiVersionId}}/relations",
          "protocol": "https",
          "host": [
            "api",
            "getpostman",
            "com"
          ],
          "path": [
            "apis",
            "{{apiId}}",
            "versions",
            "{{apiVersionId}}",
            "relations"
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json",
          "description": {
            "content": "",
            "type": "text/plain"
          }
        }
      ],
      "cookie": [
      ],
      "body": "{\n\t\"relations\": {\n\t\t\"contracttest\": {\n            \"2a9b8fa8-88b7-4b86-8372-8e3f6f6e07f2\": {\n                \"id\": \"2a9b8fa8-88b7-4b86-8372-8e3f6f6e07f2\",\n                \"name\": \"C test\",\n                \"updatedAt\": \"2019-08-29T10:18:11.000Z\"\n            }\n        },\n        \"integrationtest\": {\n            \"521b0486-ab91-4d3a-9189-43c9380a0533\": {\n                \"id\": \"521b0486-ab91-4d3a-9189-43c9380a0533\",\n                \"name\": \"C1\",\n                \"updatedAt\": \"2019-08-29T11:40:39.000Z\"\n            },\n            \"a236b715-e682-460b-97b6-c1db24f7612e\": {\n                \"id\": \"a236b715-e682-460b-97b6-c1db24f7612e\",\n                \"name\": \"C test\",\n                \"updatedAt\": \"2019-08-29T10:18:11.000Z\"\n            }\n        },\n        \"mock\": {\n            \"4ccd755f-2c80-481b-a262-49b55e12f5e1\": {\n                \"id\": \"4ccd755f-2c80-481b-a262-49b55e12f5e1\",\n                \"name\": \"Mock\",\n                \"url\": \"https://4ccd755f-2c80-481b-a262-49b55e12f5e1.mock-beta.pstmn.io\",\n                \"updatedAt\": \"2019-08-20T10:18:13.000Z\"\n            }\n        }\n\t}\n}"
    }
  ]
}