欢迎使用 Biu~ HTTP 接口调试工具,此文档用于介绍本工具的使用方法,并对一些常见问题进行简单说明。如果你在使用过程中发现程序问题,可以发送邮件与我沟通,也欢迎提出改进建议。

邮件地址:oicqsongwenjing@163.com

一、 简介

Biu~ HTTP 接口调试工具是一个简单的 Web 项目,使用 JavaScript 的 XMLHttpRequest 对象进行 HTTP 通信,可以通过配置请求报文进行接口调试。另外,由于请求是使用浏览器发送的,所以在你能够正常联通的网络上它都可以工作,包括局域网。

受浏览器的限制,本工具并不能完全自由的控制 HTTP 请求,但也由于这些特性,它特别适合 Web 项目的接口调试。

二、 Biu~Tool

跨域请求是在浏览器中使用 XMLHttpRequest 对象进行 HTTP 通信必须要解决的问题,为此,本工具提供一个 Chrome 浏览器扩展程序:[Biu~Tool],使用此扩展程序,即可实现不受限制的跨域接口调试。

由于国内网络环境的限制,Biu~Tool 并未上传到 Chrome 应用商店,你需要下载并手动安装:

下载和安装

在本站点的首页 [ https://biu.swj.name ] 可以找到 Biu~Tool 下载链接,下载后得到一个压缩文件,请将此压缩文件解压到一个相对稳定的目录,确保它不会被意外删除。

在浏览器地址栏输入:chrome://extensions,打开扩展程序管理界面。

打开“开发者模式”,点击“加载已解压的扩展程序”:

安装步骤

选择 Biu~Tool 存放的目录,即完成了安装:

安装完成

注意事项

1. 应确保 Biu~Tool 处于启用状态,但它只有在访问 biu.swj.name 时才会执行。

2. Biu~Tool 的“可读取和更改网站数据”权限应设置为:在所有网站上。这并不意味着 Biu~Tool 真的会读取和更改你访问的网站数据,它仅是为了保证扩展程序有权限进行 HTTP 通信。

不使用 Biu~Tool

如果你不想使用 Biu~Tool 扩展程序,当然也可以,但应保证调试的接口能够跨域访问。

在 Microsoft Edge 上使用 Biu~Tool

Biu~Tool 也可以在 Chromium 内核的 Microsoft Edge 上使用,安装方法与 Chrome 类似。

三、 简单使用

简单的介绍下本工具的使用方法,呃…… 算了,很简单,不介绍了,自己研究吧。

四、 安全性

本站点是一个纯前端项目,不会在服务端记录使用过程中产生的任何数据。

本工具的全部代码(包括 Biu~Tool)都未进行压缩和混淆,可以通过浏览器的开发者工具查阅。

存储功能使用 IndexedDB 实现,数据保存在本地浏览器中,不会上传至服务器。

五、 常见问题

1. HTTP/HTTPS

本站点的访问强制使用 HTTPS 协议,如果调试的接口是 HTTP 的,因为协议不同,会产生跨域问题,此问题目前只能通过安装 Biu~Tool 扩展程序解决。

2. 如何查看真实的请求头

由于使用 XMLHttpRequest 发送请求,本工具并不能完全自由的控制请求报文内容,有一部分内容是浏览器自动设置的,如果希望查看真实的请求报文,请参照以下方法:

如果未安装 Biu~Tool 扩展程序,可以打开浏览器的开发者工具,在 Network 标签下查看。

如果安装了 Biu~Tool 扩展程序,那么需要打开扩展程序的背景页查看。

查看背景页

六、 更新记录

2021-03-13

初始版本上线

2021-04-04

禁用 CONNECT、TRACE、TRACK 请求方法。