ＰＵＴ更新集合
https://api.getpostman.com/collections/{{collection_uid}}
这个端点允许你通过Postman Collection v2格式来更新一个已存在的集合。
成功更新好集合后，响应返回一个集合的name,id,和uid.
需要API Key作为X-Api-Key请求头或apikey URL查询参数。
注意：需要小心--尝试更新集合时，已有的集合会被请求体替代。
头文件HEADERS
Content-Type: application/json
X-Api-Key: {{postman_api_key}}
请求体部分BODY
{
"collection": { "info": { "name": "sample collection 952",
"description": "This is a smple collection", "_postman_id": "174dad7d-07e4-45fe-917d-13cf84e5581f", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" },
"item": [ { "name": "This is a folder", "item": [ { "name": "sample POST Request",
"request": { "url": "https://postman-echo.com/post", "method": "POST",
"header": [ { "key": "Content-Type", "value": "application/json" } ] ,
"body": { "mode": "raw", "raw": "{\"data\": \"123\"} },
"description": "This is a smple POST Request" } } ] },
{ "name": "smaple GET Request", "request": { "url": "https://postman-echo/get",
"method": "GET", "description": "This is a smple GET Request"
} } ] } }
示例请求：更新后的集合
curl --location --request PUT "https://api.getpostman.com/collections/{{collection_uid}}"
--header "Content-Type": application/json" \
--header "X-Api-Key": {{postman_api_key}}" \
--data "{ \"collection\": { \"variables\": [ ], \"info\": { \"name\": \"sample collection\",
\"_postman_id\": \"1d4daef5-2021-4581-ab84-bdfe5d5f5a55\",
\"description\": \"This is just a smple collection.\",
\"schema\": \"https://schema.getpostman.com/json/collection/v2.0.0/collection.json"
},
\"item\": [ { \"name\": \"This is a folder\", \"description\": \"\",
\"item\": [ { \"_postman_id\": \"c5e8d7ef-909d-4v57-wef2-8609wc501586\",
\"name\": \"smple POST Request\",
\"request\": { \"url\": \"echo.getpostman.com/post\", \"method\": \"POST\",
\"header\": [ { \"key\": \"Content-Type\", \"value\": \"application/json\",
\"description\": \"\" } ],
\"body\": { \"mode\": \"raw\", \"raw\": \"{ \ \ \\\"data\\\": \\\"123\\\"\ } \" } ,
\"description\": \"This is a smple POST Request\" },
\"response\": [ ] } ] },
{ \"name\": \"This is a second folder\", \"description\": \"This is the second folder\",
\"item\": [ ] } ,
{ \"name\": "smple GET Request\", \"request\": { \"url\": \"echo.getpostman.com/get\",
\"method\": \"GET\", \"header\": [ ], \"body\": { \"mode\": \"formdata\" , \"formdata\": [] },
\"description\": \"This is the second request\" } ,
\"response\": [ ] } ] } }＂
DEL删除集合
https://api.getpostman.com/collections/{{collection_uid}}
这个端点允许你来删除已有的集合。
完成集合删除后，响应返回id,uid.
需要API Key作为X-Api-Key请求头文件或apikey URL查询参数。
头文件HEADERS
X-Api-Key: {{postman_api_key}}
请求栗子：
已删除的集合：
curl --location --request DELETE "https://api.getpostman.com/collections/{{collection_uid}}"\
--header "X-Api-Key: {{postman-api-key}}" \
--data ""
响应栗子：
200 - OK
{ "collection": { "id": "a14d5d5-afba-4a82-bf22-413febaaedaa2a",
"uid": "5513-a1413113aaaedade-4132-aewefwffewfe13"
}
}
环境变量
GET 所有的环境变量: https://api.getpostman.com/environments
/environments端点返回一个所有环境变量的集合。
响应包括一个环境变量信息的数组内容有name,id,owner和uid.
需要API Key作为X-Api-Key0请求头或apikey0 URL查询参数。
头文件HEADERS
X-Api-Key: {{postman_api_key}}
请求实力：
有效的响应:
curl --location --request GET "https://api.getpostman.com/environments" \
--header "X-Api-Key: {{postman_api_key}}"
响应实力：
200 - OK
{ "environments": [ { "id": "357668d2-84f1-2213-438b-11309592f81",
"name": "Postman cloud API",
"owner": "621342", "uid": "621342-357668d2-84f1-2213-438b-11309592f81"},
{ "id": "841d135fe-f4b1-9120-5f11-a73b17818d70",
"name": "Postman Cloud API.template",
"owner": "621245",
"uid": "621245-841d135fe-f4b1-9120-5f11-a73b17818d70"} ] }
GET 单一环境变量
https://api.getpostman.com/environments//{environment_uid}}
访问一个可以访问的环境变量的内容，使用uid.
xu要API Key作为X-Api-Key请求头或apikey URL0查询参数。
头文件HEADERS
X-Api-Key: {{postman_api_key}}
请求示例：
curl --location -- request GET "https://api.getpostman.com/environments/{{environment_uid}}" \
--header "X-Api-Key: {{postman_api_key}}"
响应示例：
200 - OK
{ " environment": {
"id": "81a1139b5-f5b2-8120-5f11-a7845b458890",
"name": "Postman cloud API.template",
"values": [ { "key": "postman_api_key", "value": "", "type": "text", "enabled": true, "hovered": false } ] } }
POST 创建环境变量
https://api.getpostman.com/environments
以下是一个添加到遵循JSON格式的请求的样例体。
{ "type": "object", "properties": { "environments": {"type": "object",
"properties": { "name": { "type": "string", "maxLength": 254, "minLength": 1 },
"value": {"type": "string"}, "enabled": {"type": "boolean" } },
"required": ["key": "value"]
} } },
"required": ["name"] } },
"required": ["environment"] }
创建完成环境变量，API 返回环境变量的name和id.
也可以指定工作空间的背景来创建一个环境变量，将workspace作为查询参数传递出去。
xu要API Key作为X-Api-Key请求头或apikey URL查询参数。
头文件HEADERS
Content-Type: application/json
X-Api-Key: {{postman_api_key}}
请求体部分：
{ "environment": { "name": "smple environment name (required)",
"values": [ "key": "variable_name_1", "value": "the value of the variable"},
{"key": "variable_name_2", "value": ""} ] } }
示例请求：
失败的响应
url --location --request POST "https://api.getpostman.com/environments" \
--header "Content-Type: application/json" \
--header "X-Api-Key: {{postman_api_key}}" \
--data "{ } "
示例响应
400 - bad请求
{ "error": { "name": "malformedRequestError",
"message": "Missing required property: environment"
} }
PUT 更新环境变量
https://api.getpostman.com/environments/{{environment_uid}}
这个端点替代已存在的环境变量。
以下是一个符合JSON格式的请求体：
{ "type": "object", "properties": { "environment": { "type": "object",
"properties": { "name": { "type": "string", "maxLength": 254, "minLength": 1 },
"values": { "type": "array", "maxItems": 100, "additionalItems": false,
"items": { "type": "object", "properties": { "key" : {"type": "string", "maxLength":254, "minLength":1 },
"value": { "type": "string", "maxLength": 254, "minLength":1 },
"type": {"type": "string" }, "enabled": { "type": "boolean" } },
"required": [ "key","value" ] } }
} } },
"required": [ "environment" ] }
完成环境变量的更新，API返回环境变量的name和 id.
xu要API Key作为X-Api-Key请求头或apikey URL查询参数。
头文件HEADERS
Content-Type: application/json
X-Api-Key: {{postman_api_key}}
请求体部分：
{ "environment": { "name": "New Name", "values": [ "key": "name", "value":"Bruce Wayne" },
{"key":"occupation", "value": "Vigilante" } ] } }
示例请求
成功的请求
url --location --request PUT "https://api.getpostman.com/environments/{{environment_uid}}" \
--header "Content-Type: application/json" \
--header "X-Api-Key: {{postman_api_key}}" \
--data "{ \"environments\": { \"name\": \"New Name\",
\"values\": [ { \"key\": \"name\", \"value\": \"Bruce Wayne\"},
{\"key\": \"occupation\", \"value\": \"Vigilante\" }
] } },
示例响应
200 - OK
{ "environment" : { "id": "957128dd-84f2-2213-438e-1309521342",
"name": "New Name", "uid": "421315-957128dd-84f2-2213-438e-1309521342"
}}
DEL 删除环境变量
https://api.getpostman.com/environments/{{environment_uid}}
这个端点允许给予环境变量的uid来删除一个环境变量。
xu要API Key作为X-Api-Key请求头文件或apikey URL查询参数。
头文件HEADERS
X-Api-Key: {{postman_api_key}}
示例请求
环境变量未找到
url --location --request DELETE "https://api.getpostman.com/environments/{{environment_uid}}"\
--header "X-Api-Key: {{postman_api_key}}"
示例响应
404 - 未找到
{"error" : { "name": "instanceNotFoundError",
"message": "The specified environment does not exist." }
}
IT的技术掌握起来真的要耗费很多时间和精力，本篇耗费了3个小时，还只是初步过了一遍，具体使用不包括。不得不感叹，做IT这么耗时耗精力薪水还那么低，已经不是一开始很多人认为的高薪饭碗了。技术那么多，只掌握一个技术就要耗费很多精力，而工作上的要求很高，不可能让你拿工作项目来练手。做IT是个苦差事啊。