Objective-C / Postman API / Import external API specification
Back to Collection Items
#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <NSString.h>
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;
// 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"
// }
// }
// }
// }
// }
// }
// }
// }
// }
// }
// }
// }
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"type" value: @"json"];
[json UpdateString: @"input.openapi" value: @"3.0.0"];
[json UpdateString: @"input.info.version" value: @"1.0.0"];
[json UpdateString: @"input.info.title" value: @"Swagger Petstore"];
[json UpdateString: @"input.info.license.name" value: @"MIT"];
[json UpdateString: @"input.servers[0].url" value: @"http://petstore.swagger.io/v1"];
[json UpdateString: @"input.paths./pets.get.summary" value: @"List all pets"];
[json UpdateString: @"input.paths./pets.get.operationId" value: @"listPets"];
[json UpdateString: @"input.paths./pets.get.parameters[0].name" value: @"limit"];
[json UpdateString: @"input.paths./pets.get.parameters[0].in" value: @"query"];
[json UpdateString: @"input.paths./pets.get.parameters[0].description" value: @"limit"];
[json UpdateBool: @"input.paths./pets.get.parameters[0].required" value: NO];
[json UpdateString: @"input.paths./pets.get.parameters[0].schema.type" value: @"integer"];
[json UpdateString: @"input.paths./pets.get.parameters[0].schema.format" value: @"int32"];
[json UpdateString: @"input.paths./pets.get.responses.default.description" value: @"unexpected error"];
[json UpdateString: @"input.paths./pets.get.responses.default.content.application/json.schema.required[0]" value: @"code"];
[json UpdateString: @"input.paths./pets.get.responses.default.content.application/json.schema.required[1]" value: @"message"];
[json UpdateString: @"input.paths./pets.get.responses.default.content.application/json.schema.properties.code.type" value: @"integer"];
[json UpdateString: @"input.paths./pets.get.responses.default.content.application/json.schema.properties.code.format" value: @"int32"];
[json UpdateString: @"input.paths./pets.get.responses.default.content.application/json.schema.properties.message.type" value: @"string"];
[http SetRequestHeader: @"Content-Type" value: @"application/json"];
[http SetRequestHeader: @"X-API-Key" value: @"{{postman_api_key}}"];
CkoHttpResponse *resp = [http PostJson3: @"https://api.getpostman.com/import/openapi" contentType: @"application/json" json: json];
if (http.LastMethodSuccess == NO) {
NSLog(@"%@",http.LastErrorText);
return;
}
CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
[resp GetBodySb: sbResponseBody];
CkoJsonObject *jResp = [[CkoJsonObject alloc] init];
[jResp LoadSb: sbResponseBody];
jResp.EmitCompact = NO;
NSLog(@"%@",@"Response Body:");
NSLog(@"%@",[jResp Emit]);
int respStatusCode = [resp.StatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
NSLog(@"%@",@"Response Header:");
NSLog(@"%@",resp.Header);
NSLog(@"%@",@"Failed.");
return;
}
// 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
NSString *id = 0;
NSString *name = 0;
NSString *uid = 0;
int i = 0;
int count_i = [[jResp SizeOfArray: @"collections"] intValue];
while (i < count_i) {
jResp.I = [NSNumber numberWithInt: i];
id = [jResp StringOf: @"collections[i].id"];
name = [jResp StringOf: @"collections[i].name"];
uid = [jResp StringOf: @"collections[i].uid"];
i = i + 1;
}
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}"
}
]
}
