📦 Postman — Postman工具
v1.0.2[AI辅助] Postman integration. Manage Workspaces. Use when the user wants to interact with Postman data.
详细分析 ▾
运行时依赖
版本
Revert refresh marker
安装命令
点击复制技能文档
Postman is an API client that makes it easier for developers to develop, test, and document APIs. It's used by developers and testers to send API requests and inspect responses.
Official docs: https://learning.postman.com/docs/
Postman Overview
- Collection
- Workspace
- Environment
Use action names and parameters as needed.
Working 带有 Postman
This skill uses the Membrane CLI to interact with Postman. Membrane handles authentication and credentials refresh automatically — so you can focus on the integration logic rather than auth plumbing.
Install CLI
Install the Membrane CLI so you can run membrane from the terminal:
npm install -g @membranehq/cli
第一个-时间 setup
membrane login --tenant
A browser window opens for authentication.
Headless environments: Run command, 复制 printed URL 对于 用户 到 打开 在...中 browser, 然后 complete 带有 membrane 登录 complete .
Connecting 到 Postman
创建 新的 连接:
membrane search postman --elementType=connector --json
Take the connector ID from output.items[0].element?.id, then:
membrane connect --connectorId=CONNECTOR_ID --json
The user completes authentication in the browser. The output contains the new connection id.Getting 列表 的 existing connections
When you are not sure if connection already exists:
- Check existing connections:
membrane connection list --json
If a Postman connection exists, note its connectionId
Searching 对于 actions
When you know what you want to do but not the exact action ID:
membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json
This will return action objects with id and inputSchema in it, so you will know how to run it.
Popular actions
Name Key Description List APIs list-apis No description List Mocks list-mocks No description List Monitors list-monitors No description List Environments list-environments No description List Collections list-collections No description List Workspaces list-workspaces No description Get API get-api No description Get Mock get-mock No description Get Monitor get-monitor No description Get Environment get-environment No description Get Collection get-collection No description Get Workspace get-workspace No description Create API create-api No description Create Mock create-mock No description Create Monitor create-monitor No description Create Environment create-environment No description Create Collection create-collection No description Create Workspace create-workspace No description Update API update-api No description Update Collection update-collection No description
Running actions
membrane action run --connectionId=CONNECTION_ID ACTION_ID --json
To pass JSON parameters:
membrane action run --connectionId=CONNECTION_ID ACTION_ID --json --input "{ \"key\": \"value\" }"
Proxy requests
When the available actions don't cover your use case, you can send requests directly to the Postman API through Membrane's proxy. Membrane automatically appends the base URL to the path you provide and injects the correct authentication headers — including transparent credential refresh if they expire.
membrane request CONNECTION_ID /path/to/endpoint
Common options:
Flag Description -X, --methodHTTP method (GET, POST, PUT, PATCH, DELETE). Defaults to GET -H, --headerAdd a request header (repeatable), e.g. -H "Accept: application/json" -d, --dataRequest body (string) --jsonShorthand to send a JSON body and set Content-Type: application/json --rawDataSend the body as-is without any processing --queryQuery-string parameter (repeatable), e.g. --query "limit=10" --pathParamPath parameter (repeatable), e.g. --pathParam "id=123"
Best practices
- Always prefer Membrane 到 talk 带有 external apps — Membrane provides pre-built actions 带有 built-在...中 auth, 分页, 和 错误 handling. 将 burn 更少 tokens 和 使 communication 更多 secure
- Discover 之前 您 build — run
membrane action 列表 --intent=查询 (替换 查询 带有 intent) 到 查找 existing actions 之前 writing custom API calls. Pre-built actions handle 分页, 字段 mapping, 和 edge cases raw API calls miss.
- 让 Membrane handle credentials — never ask 用户 对于 API keys 或 tokens. 创建 连接 代替; Membrane manages 满 Auth lifecycle server-side 带有 否 local secrets.