delphiAx / Postman API / Import external API specification
Back to Collection Items
var
http: TChilkatHttp;
success: Integer;
json: TChilkatJsonObject;
resp: IChilkatHttpResponse;
sbResponseBody: TChilkatStringBuilder;
jResp: TChilkatJsonObject;
respStatusCode: Integer;
id: WideString;
name: WideString;
uid: WideString;
i: Integer;
count_i: Integer;
begin
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
http := TChilkatHttp.Create(Self);
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "type": "json",
// "input": {
// "openapi": "3.0.0",
// "info": {
// "version": "1.0.0",
// "title": "Swagger Petstore",
// "license": {
// "name": "MIT"
// }
// },
// "servers": [
// {
// "url": "http://petstore.swagger.io/v1"
// }
// ],
// "paths": {
// "/pets": {
// "get": {
// "summary": "List all pets",
// "operationId": "listPets",
// "parameters": [
// {
// "name": "limit",
// "in": "query",
// "description": "limit",
// "required": false,
// "schema": {
// "type": "integer",
// "format": "int32"
// }
// }
// ],
// "responses": {
// "default": {
// "description": "unexpected error",
// "content": {
// "application/json": {
// "schema": {
// "required": [
// "code",
// "message"
// ],
// "properties": {
// "code": {
// "type": "integer",
// "format": "int32"
// },
// "message": {
// "type": "string"
// }
// }
// }
// }
// }
// }
// }
// }
// }
// }
// }
// }
json := TChilkatJsonObject.Create(Self);
json.UpdateString('type','json');
json.UpdateString('input.openapi','3.0.0');
json.UpdateString('input.info.version','1.0.0');
json.UpdateString('input.info.title','Swagger Petstore');
json.UpdateString('input.info.license.name','MIT');
json.UpdateString('input.servers[0].url','http://petstore.swagger.io/v1');
json.UpdateString('input.paths./pets.get.summary','List all pets');
json.UpdateString('input.paths./pets.get.operationId','listPets');
json.UpdateString('input.paths./pets.get.parameters[0].name','limit');
json.UpdateString('input.paths./pets.get.parameters[0].in','query');
json.UpdateString('input.paths./pets.get.parameters[0].description','limit');
json.UpdateBool('input.paths./pets.get.parameters[0].required',0);
json.UpdateString('input.paths./pets.get.parameters[0].schema.type','integer');
json.UpdateString('input.paths./pets.get.parameters[0].schema.format','int32');
json.UpdateString('input.paths./pets.get.responses.default.description','unexpected error');
json.UpdateString('input.paths./pets.get.responses.default.content.application/json.schema.required[0]','code');
json.UpdateString('input.paths./pets.get.responses.default.content.application/json.schema.required[1]','message');
json.UpdateString('input.paths./pets.get.responses.default.content.application/json.schema.properties.code.type','integer');
json.UpdateString('input.paths./pets.get.responses.default.content.application/json.schema.properties.code.format','int32');
json.UpdateString('input.paths./pets.get.responses.default.content.application/json.schema.properties.message.type','string');
http.SetRequestHeader('Content-Type','application/json');
http.SetRequestHeader('X-API-Key','{{postman_api_key}}');
resp := http.PostJson3('https://api.getpostman.com/import/openapi','application/json',json.ControlInterface);
if (http.LastMethodSuccess = 0) then
begin
Memo1.Lines.Add(http.LastErrorText);
Exit;
end;
sbResponseBody := TChilkatStringBuilder.Create(Self);
resp.GetBodySb(sbResponseBody.ControlInterface);
jResp := TChilkatJsonObject.Create(Self);
jResp.LoadSb(sbResponseBody.ControlInterface);
jResp.EmitCompact := 0;
Memo1.Lines.Add('Response Body:');
Memo1.Lines.Add(jResp.Emit());
respStatusCode := resp.StatusCode;
Memo1.Lines.Add('Response Status Code = ' + IntToStr(respStatusCode));
if (respStatusCode >= 400) then
begin
Memo1.Lines.Add('Response Header:');
Memo1.Lines.Add(resp.Header);
Memo1.Lines.Add('Failed.');
Exit;
end;
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "collections": [
// {
// "id": "e956ff02-7597-4f8d-a5e7-1c18208c9e56",
// "name": "Swagger Petstore",
// "uid": "2282-e956ff02-7597-4f8d-a5e7-1c18208c9e56"
// }
// ]
// }
// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
i := 0;
count_i := jResp.SizeOfArray('collections');
while i < count_i do
begin
jResp.I := i;
id := jResp.StringOf('collections[i].id');
name := jResp.StringOf('collections[i].name');
uid := jResp.StringOf('collections[i].uid');
i := i + 1;
end;
Curl Command
curl -X POST
-H "X-API-Key: {{postman_api_key}}"
-H "Content-Type: application/json"
-d '{
"type" : "json",
"input": {
"openapi": "3.0.0",
"info": {
"version": "1.0.0",
"title": "Swagger Petstore",
"license": {
"name": "MIT"
}
},
"servers": [
{
"url": "http://petstore.swagger.io/v1"
}
],
"paths": {
"/pets": {
"get": {
"summary": "List all pets",
"operationId": "listPets",
"parameters": [
{
"name": "limit",
"in": "query",
"description": "limit",
"required": false,
"schema": {
"type": "integer",
"format": "int32"
}
}
],
"responses": {
"default": {
"description": "unexpected error",
"content": {
"application/json": {
"schema": {
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"format": "int32"
},
"message": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}
}'
https://api.getpostman.com/import/openapi
Postman Collection Item JSON
{
"name": "Import external API specification",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"type\" : \"json\",\n \"input\": {\n \"openapi\": \"3.0.0\",\n \"info\": {\n \t \"version\": \"1.0.0\",\n \t \"title\": \"Swagger Petstore\",\n \t \"license\": {\n \t \"name\": \"MIT\"\n \t }\n },\n \"servers\": [\n {\n \"url\": \"http://petstore.swagger.io/v1\"\n }\n ],\n \"paths\": {\n \t \"/pets\": {\n \"get\": {\n \"summary\": \"List all pets\",\n \"operationId\": \"listPets\",\n \"parameters\": [\n {\n \"name\": \"limit\",\n \"in\": \"query\",\n \"description\": \"limit\",\n \"required\": false,\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"description\": \"unexpected error\",\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"required\": [\n \"code\",\n \"message\"\n ],\n \"properties\": {\n \"code\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n }\n }\n }\n }\n }\n}"
},
"url": {
"raw": "https://api.getpostman.com/import/openapi",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
]
},
"description": "This endpoint allows you to import external API specifications into Postman.\n\nCurrently, this endpoint only supports the <a href=\"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md\">OpenAPI</a> specification, for which the `importType` will be `openapi`.\n\nOn a successful import, the response will be an array with each element contaning `id`, `name` and `uid` of entities created.\n\nSupported `type`s:\n\n- string\n- json\n- file\n\nThe `input` parameter should be defined based on the `type`.\n\n> To import a file, request body must be form-data with `type` param set to `file`.\n\n**Note**: Refer to examples for different scenarios.\n\n> Requires <a href=\"#authentication\">API Key</a> as `X-Api-Key` request header."
},
"response": [
{
"name": "Success: Import to a specific workspace with workspace ID passed in the header",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "X-Workspace-Id",
"value": "c90a3482-f80d-43d6-9dfb-0830f5e43605"
},
{
"name": "Content-Type",
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"type\" : \"json\",\n \"input\": {\n \"openapi\": \"3.0.0\",\n \"info\": {\n \t \"version\": \"1.0.0\",\n \t \"title\": \"Swagger Petstore\",\n \t \"license\": {\n \t \"name\": \"MIT\"\n \t }\n },\n \"servers\": [\n {\n \"url\": \"http://petstore.swagger.io/v1\"\n }\n ],\n \"paths\": {\n \t \"/pets\": {\n \"get\": {\n \"summary\": \"List all pets\",\n \"operationId\": \"listPets\",\n \"parameters\": [\n {\n \"name\": \"limit\",\n \"in\": \"query\",\n \"description\": \"limit\",\n \"required\": false,\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"description\": \"unexpected error\",\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Error\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"Error\": {\n \"required\": [\n \"code\",\n \"message\"\n ],\n \"properties\": {\n \"code\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n}"
},
"url": {
"raw": "https://api.getpostman.com/import/openapi",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
],
"variable": [
{
"key": "import_type",
"value": "openapi"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": {
"content": "",
"type": "text/plain"
}
}
],
"cookie": [
],
"body": "{\n \"collections\": [\n {\n \"id\": \"e956ff02-7597-4f8d-a5e7-1c18208c9e56\",\n \"name\": \"Swagger Petstore\",\n \"uid\": \"2282-e956ff02-7597-4f8d-a5e7-1c18208c9e56\"\n }\n ]\n}"
},
{
"name": "Success: Import a file",
"originalRequest": {
"method": "POST",
"header": [
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "type",
"value": "file",
"type": "text"
},
{
"key": "input",
"value": "",
"description": "A file with the specifications",
"type": "file"
}
]
},
"url": {
"raw": "https://api.getpostman.com/import/openapi",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
],
"variable": [
{
"key": "import_type",
"value": ""
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": {
"content": "",
"type": "text/plain"
}
}
],
"cookie": [
],
"body": "{\n \"collections\": [\n {\n \"id\": \"c74f2169-0c59-49f6-b04f-fdec4aba3db3\",\n \"name\": \"demo\",\n \"uid\": \"2282-c74f2169-0c59-49f6-b04f-fdec4aba3db3\"\n },\n {\n \"id\": \"49b08197-6b3d-4957-88d3-dbba0e3ee6a0\",\n \"name\": \"demo\",\n \"uid\": \"2282-49b08197-6b3d-4957-88d3-dbba0e3ee6a0\"\n }\n ]\n}"
},
{
"name": "Success: Import - Stringified body",
"originalRequest": {
"method": "POST",
"header": [
{
"name": "Content-Type",
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"type\": \"string\",\n \"input\": \" {\\r\\n \\\"openapi\\\": \\\"3.0.0\\\",\\r\\n \\\"info\\\": {\\r\\n \\t \\\"version\\\": \\\"1.0.0\\\",\\r\\n \\t \\\"title\\\": \\\"Swagger Petstore\\\",\\r\\n \\t \\\"license\\\": {\\r\\n \\t \\\"name\\\": \\\"MIT\\\"\\r\\n \\t }\\r\\n },\\r\\n \\\"servers\\\": [\\r\\n {\\r\\n \\\"url\\\": \\\"http:\\/\\/petstore.swagger.io\\/v1\\\"\\r\\n }\\r\\n ],\\r\\n \\\"paths\\\": {\\r\\n \\t \\\"\\/pets\\\": {\\r\\n \\\"get\\\": {\\r\\n \\\"summary\\\": \\\"List all pets\\\",\\r\\n \\\"operationId\\\": \\\"listPets\\\",\\r\\n \\\"parameters\\\": [\\r\\n {\\r\\n \\\"name\\\": \\\"limit\\\",\\r\\n \\\"in\\\": \\\"query\\\",\\r\\n \\\"description\\\": \\\"limit\\\",\\r\\n \\\"required\\\": false,\\r\\n \\\"schema\\\": {\\r\\n \\\"type\\\": \\\"integer\\\",\\r\\n \\\"format\\\": \\\"int32\\\"\\r\\n }\\r\\n }\\r\\n ],\\r\\n \\\"responses\\\": {\\r\\n \\\"default\\\": {\\r\\n \\\"description\\\": \\\"unexpected error\\\",\\r\\n \\\"content\\\": {\\r\\n \\\"application\\/json\\\": {\\r\\n \\\"schema\\\": {\\r\\n \\\"$ref\\\": \\\"#\\/components\\/schemas\\/Error\\\"\\r\\n }\\r\\n }\\r\\n }\\r\\n }\\r\\n }\\r\\n }\\r\\n }\\r\\n },\\r\\n \\\"components\\\": {\\r\\n \\\"schemas\\\": {\\r\\n \\\"Error\\\": {\\r\\n \\\"required\\\": [\\r\\n \\\"code\\\",\\r\\n \\\"message\\\"\\r\\n ],\\r\\n \\\"properties\\\": {\\r\\n \\\"code\\\": {\\r\\n \\\"type\\\": \\\"integer\\\",\\r\\n \\\"format\\\": \\\"int32\\\"\\r\\n },\\r\\n \\\"message\\\": {\\r\\n \\\"type\\\": \\\"string\\\"\\r\\n }\\r\\n }\\r\\n }\\r\\n }\\r\\n }\\r\\n }\\r\\n\"\n}"
},
"url": {
"raw": "https://api.getpostman.com/import/openapi",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
],
"variable": [
{
"key": "import_type",
"value": "openapi"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": {
"content": "",
"type": "text/plain"
}
}
],
"cookie": [
],
"body": "{\n \"collections\": [\n {\n \"id\": \"401fcf93-9c45-4832-9616-6c6b698eeda6\",\n \"name\": \"Swagger Petstore\",\n \"uid\": \"2282-401fcf93-9c45-4832-9616-6c6b698eeda6\"\n }\n ]\n}"
},
{
"name": "Success: Import to a specific workspace with workspace ID passed as a query parameter",
"originalRequest": {
"method": "POST",
"header": [
{
"name": "Content-Type",
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"type\" : \"json\",\n \"input\": {\n \"openapi\": \"3.0.0\",\n \"info\": {\n \t \"version\": \"1.0.0\",\n \t \"title\": \"Swagger Petstore\",\n \t \"license\": {\n \t \"name\": \"MIT\"\n \t }\n },\n \"servers\": [\n {\n \"url\": \"http://petstore.swagger.io/v1\"\n }\n ],\n \"paths\": {\n \t \"/pets\": {\n \"get\": {\n \"summary\": \"List all pets\",\n \"operationId\": \"listPets\",\n \"parameters\": [\n {\n \"name\": \"limit\",\n \"in\": \"query\",\n \"description\": \"limit\",\n \"required\": false,\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"description\": \"unexpected error\",\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Error\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"Error\": {\n \"required\": [\n \"code\",\n \"message\"\n ],\n \"properties\": {\n \"code\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n}"
},
"url": {
"raw": "https://api.getpostman.com/import/openapi?workspace=c90a3482-f80d-43d6-9dfb-0830f5e43605",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
],
"query": [
{
"key": "workspace",
"value": "c90a3482-f80d-43d6-9dfb-0830f5e43605"
}
],
"variable": [
{
"key": "import_type",
"value": "openapi"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": {
"content": "",
"type": "text/plain"
}
}
],
"cookie": [
],
"body": "{\n \"collections\": [\n {\n \"id\": \"b31be584-1b1e-4444-b581-761edf88fe77\",\n \"name\": \"Swagger Petstore\",\n \"uid\": \"2282-b31be584-1b1e-4444-b581-761edf88fe77\"\n }\n ]\n}"
},
{
"name": "Error: Invalid Params",
"originalRequest": {
"method": "POST",
"header": [
{
"name": "Content-Type",
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"type\" : \"invalid_type\",\n \"input\": {\n \"openapi\": \"3.0.0\",\n \"info\": {\n \t \"version\": \"1.0.0\",\n \t \"title\": \"Swagger Petstore\",\n \t \"license\": {\n \t \"name\": \"MIT\"\n \t }\n },\n \"servers\": [\n {\n \"url\": \"http://petstore.swagger.io/v1\"\n }\n ],\n \"paths\": {\n \t \"/pets\": {\n \"get\": {\n \"summary\": \"List all pets\",\n \"operationId\": \"listPets\",\n \"parameters\": [\n {\n \"name\": \"limit\",\n \"in\": \"query\",\n \"description\": \"limit\",\n \"required\": false,\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"description\": \"unexpected error\",\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Error\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"Error\": {\n \"required\": [\n \"code\",\n \"message\"\n ],\n \"properties\": {\n \"code\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n}"
},
"url": {
"raw": "https://api.getpostman.com/import/openapi",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
],
"variable": [
{
"key": "import_type",
"value": "openapi"
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": {
"content": "",
"type": "text/plain"
}
}
],
"cookie": [
],
"body": "{\n \"error\": {\n \"name\": \"invalidParamsError\",\n \"message\": \"The request body has invalid values for the type parameter. Value must be one of file, string, json\",\n \"details\": {\n \"param\": \"type\"\n }\n }\n}"
},
{
"name": "Error: Param Missing",
"originalRequest": {
"method": "POST",
"header": [
{
"name": "Content-Type",
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "formdata",
"formdata": [
]
},
"url": {
"raw": "https://api.getpostman.com/import/openapi",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
],
"variable": [
{
"key": "import_type",
"value": "openapi"
}
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": {
"content": "",
"type": "text/plain"
}
}
],
"cookie": [
],
"body": "{\n \"error\": {\n \"name\": \"paramMissingError\",\n \"message\": \"The request body is missing a value for the type parameter. Check your request and try again.\",\n \"details\": {\n \"param\": \"type\"\n }\n }\n}"
},
{
"name": "Error: Malformed Request",
"originalRequest": {
"method": "POST",
"header": [
{
"name": "Content-Type",
"key": "Content-Type",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"type\" : \"json\",\n \"input\": {\n \"info\": {\n \t \"version\": \"1.0.0\",\n \t \"title\": \"Swagger Petstore\",\n \t \"license\": {\n \t \"name\": \"MIT\"\n \t }\n },\n \"servers\": [\n {\n \"url\": \"http://petstore.swagger.io/v1\"\n }\n ],\n \"paths\": {\n \t \"/pets\": {\n \"get\": {\n \"summary\": \"List all pets\",\n \"operationId\": \"listPets\",\n \"parameters\": [\n {\n \"name\": \"limit\",\n \"in\": \"query\",\n \"description\": \"limit\",\n \"required\": false,\n \"schema\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n }\n }\n ],\n \"responses\": {\n \"default\": {\n \"description\": \"unexpected error\",\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"$ref\": \"#/components/schemas/Error\"\n }\n }\n }\n }\n }\n }\n }\n },\n \"components\": {\n \"schemas\": {\n \"Error\": {\n \"required\": [\n \"code\",\n \"message\"\n ],\n \"properties\": {\n \"code\": {\n \"type\": \"integer\",\n \"format\": \"int32\"\n },\n \"message\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n}"
},
"url": {
"raw": "https://api.getpostman.com/import/openapi",
"protocol": "https",
"host": [
"api",
"getpostman",
"com"
],
"path": [
"import",
"openapi"
],
"variable": [
{
"key": "import_type",
"value": "openapi"
}
]
}
},
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": {
"content": "",
"type": "text/plain"
}
}
],
"cookie": [
],
"body": "{\n \"error\": {\n \"name\": \"malformedRequestError\",\n \"message\": \"The specified openapi data is invalid. Please fix the following details as per the spec.\",\n \"details\": \"Specification must contain a semantic version number of the OAS specification\"\n }\n}"
}
]
}
