应用介绍
Postboy 接口调试客户端的版本分发页:在这里取客户端的最新版或指定历史版本安装包。
它解决什么问题
做接口联调时,你常常需要绕过页面、直接向后端地址发一个请求:确认返回结构对不对、复现某个只在特定参数下出现的问题、看看接口在预发环境是否正常。这件事在普通网页里做不完整——浏览器有同源策略,跨域请求会被拦下,你拿不到真实的响应头与错误信息。这也是接口调试工具多以桌面客户端形态存在的原因。
但换成客户端形态,另一个麻烦就来了:安装包从哪拿?团队里谁手里是新版、谁是旧版?线上问题只在某个旧版本上复现,需要装回那一版,又该去哪里找?靠聊天窗口与网盘传文件,最后往往分不清手上这份到底是什么版本。
这个页面把「版本」固定成一个入口:最新版一个按钮,历史版本一个列表,选中即下载。文件存放在服务端资源库中,页面上的下载地址按文件的 md5 生成,不依赖文件名。
需要说明的是:这个页面本身不发送接口请求、也不保存请求历史,它只负责把客户端交到你手上;真正的调试动作在下载后的客户端里完成。
核心功能
- 最新版下载:点「Postboy最新版下载链接」,向服务端资源库查询最近一次上传的文件,取得其 md5 后直接打开下载地址。
- 历史版本列表:点开「Postboy历史版本」下拉,列出资源库中 Postboy 类型的全部文件记录(含 md5、文件名、类型、mime),选中任一项即下载对应文件。
- 管理员上传版本:具备 postboy 项目权限的账号可在同一页面选择本地文件上传,扩展名限定
.exe/.zip;内容已存在(md5 相同)的文件会被服务端拒绝并提示。 - 登录校验:页面加载时调用登录状态接口,未登录会跳转到登录页。
怎么用
- 1打开
/wit-lab/postboy,未登录会先跳转登录。 - 2点「Postboy最新版下载链接」,获取最新版本文件。
- 3需要旧版本时点开「Postboy历史版本」,从列表中选中目标文件下载。
- 4管理员点「管理员上传版本」,选择
.exe或.zip提交;上传成功后该文件成为新的「最新版」。
常见问题
Q:网页上能直接发接口请求吗?
A:不能。这个页面是客户端的分发入口,只提供下载与版本管理,不做请求发送与响应查看。
Q:为什么下载地址是一串 md5,而不是文件名?
A:下载地址由服务端按文件内容计算出的 md5 标识拼接而成,同名不同内容的文件不会互相覆盖,重复上传相同内容也会被识别出来。
Q:可以上传什么格式的安装包?
A:服务端只接受 .exe 和 .zip,其它扩展名会在校验环节被拒绝。
Q:历史版本会一直保留吗?
A:页面只列出资源库中当前存在的 Postboy 文件,不做清理也不做归档承诺;是否长期可下载取决于服务端资源库的维护情况。
Q:没登录能用吗?
A:页面会检测登录状态并跳转登录页;上传接口还会额外校验账号是否具备 postboy 项目权限。