版本要求:
2023.2.3
提示
由于历史原因,历史保存的持久化数据丢失了一部分字段,为了能够将同步至postman的数据更完整, 建议在插件postman配置中勾上
保存后同步
postman选项,通过保存操作来触发同步.
同时推荐使用该功能来同步api而不是导出
Postman API 用量问题
插件使用 Postman API 来同步数据,需要注意的是 Postman 同步涉及到 Postman API 的
用量
问题,点击链接需要注意
Postman API Usage
这一栏,每月最多免费使用 1000次。超过额度会导致同步失败!
Api key 用于使用 Postman 在线 API 执行一些手工行为.例如
创建Collection
、
创建目录
、
创建 Request
等行为.
打开
https://postman.co/settings/me/api-keys
并登录,并执行创建.注意最好是创建一个没有有效期的Api key.
Workspace id 是 Postman 工作空间的Id. 有2中策略来创建Workspace
-
每个项目来区分创建1个Workspace(推荐)
-
创建1个Workspace表示某个公司的,不同的Collection来表示公司下面不同的项目
获取WorkspaceId的步骤如下↓↓↓
a. 创建一个 Workspace,已有则忽略
b. 点击 Workspace,并点击Workspace的info图标(注意不是点击Workspace Settings)
c.复制得到Workspace id
Environment 中变量的值包含
Initial value
和
Current value
,
Initial value
是云端共享的,与之对应的
Current value
仅保留在本地. Postman中实际Request使用的是
Current value
.
但是,
Restful Fast Request在对 Environment 同步的时候同步的是 Initial value
.
所以如果插件中更新了 Environment 值,并且同步到了 Postman ,此时在 Postman 中执行 Request 并不会立刻使用同步的值, 而是需要在 Environment 中手工替换或者全部替换(点击Reset All).
因为语言的不同,插件并不会同步前后置脚本.所以在使用插件的时候最好把一些共用的脚本写在
项目级别配置
中的前后置脚本,这样子也只需要在同步到Postman以后, 在Postman中的Collection级别下写前后置脚本.
-
推荐勾选保存后即同步到Postman,如果没有勾选,则在手动触发的时候需要先保存,再点击同步
-
多方协作,如果发现同一个workspace出现多个相同的collection,只需使用其中一方的collection id在配置中手动替换即可
-
多方协作,如果发现同一个collection出现多个相同的folder,只需使用其中一方的
.fastRequest/collections/ROOT/模块名/类名/directory.json
中的
pmFolderId
属性即可
-
多方协作,如果发现同一个api在postman上有2份,则可以通过修改其中一份数据的
pmRequestId
和
pmResponseId
来是他们保持统一,可以通过
多窗口 Tab
来定位存储的文件.最好的方式是通过git管理提交
rapi
文件使api底层存储数据保持一致