『居善地』接口测试 — 6、Httpbin服务介绍

目录

• 1、Httpbin服务介绍
• 2、在Windows系统中部署Httpbin服务
• 3、在Linux系统中部署Httpbin服务
• 4、Httpbin访问方式
• 5、Httpbin常用调试接口
• 6、总结：

1、Httpbin服务介绍

Httpbin是使用Python + Flask语言编写的一个HTTP Request & Response Service的简单服务，该服务主要用于测试 HTTP 请求，你可以向他发送请求，然后他会按照指定的规则将你的请求返回（查看你所发送请求中的全部请求信息和响应信息）。

Httpbin支持HTTP/HTTPS请求，支持所有的HTTP动词，能测试HTTP请求和响应的各种信息，比如 cookie、ip、headers 和登录验证等。能模拟302跳转乃至302跳转的次数，还可以返回一个HTML文件或一个XML文件或一个图片文件（还支持指定返回图片的格式）。

Httpbin接口地址：http://httpbin.org/或者https://httpbin.org/

Httpbin开源地址：https://github.com/postmanlabs/httpbin

2、在Windows系统中部署Httpbin服务

Httpbin是部署在国外的，考虑到有时无法访问的情况，也是可以自己在本地搭建部署，非常简单。

这样本地部署Httpbin的方式，可以不用和外部的服务器交互就可以进行HTTP业务的调试。

（1）通过pip工具安装

需要分别安装Httpbin与guicorn，guicorn是一个wsgi http服务器，用来启动Httpbin服务。

# 进入cmd命令行，执行如下命令：
# 安装Httpbin与guicorn
pip install gunicorn
pip install httpbin

# 执行如下命令启动服务：
gunicorn httpbin:app

注意：这种方式在Windows系统下不能使用，报错ImportError: No module named 'fcntl'。（网上查的原因是fcntl模块在Windows环境下不被识别）

（2）本地安装Httpbin：

# 从github上克隆Httpbin到本地
# 会直接克隆到cmd命令的当前目录下，如C:\Users\L>下执行的命令。
git clone https://github.com/Runscope/httpbin.git

# 安装httpbin命令
pip install -e httpbin

# 启动httpbin服务命令
python -m httpbin.core [--port=PORT] [--host=HOST]
# 例如：访问方位为：http://127.0.0.1:9999/get
python -m httpbin.core --port=9999

亲测：在Windows系统下，这种方式能在本地正常启动Httpbin服务。

3、在Linux系统中部署Httpbin服务

Linux系统中我们通常使用Docker的方式部署Httpbin服务，这样非常的方便简单。

一共只有两步就可以完成：第一，拉取镜像；第二，启动镜像。

（关于Docker的安装，请看Docker部分的相关文章，这里就不在介绍了）

（1）拉取Httpbin服务的Docker镜像到本地

[root@localhost ~]# docker pull kennethreitz/httpbin
Using default tag: latest
latest: Pulling from kennethreitz/httpbin
473ede7ed136: Pull complete
c46b5fa4d940: Pull complete
93ae3df89c92: Pull complete
6b1eed27cade: Pull complete
0373952b589d: Pull complete
7b82cd0ee527: Pull complete
a36b2d884a89: Pull complete
Digest: sha256:599fe5e5073102dbb0ee3dbb65f049dab44fa9fc251f6835c9990f8fb196a72b
Status: Downloaded newer image for kennethreitz/httpbin:latest
docker.io/kennethreitz/httpbin:latest

（2）启动本地Httpbin服务的Docker镜像

[root@localhost ~]# docker run -p 80:80 kennethreitz/httpbin
[2021-05-20 02:13:00 +0000] [1] [INFO] Starting gunicorn 19.9.0
[2021-05-20 02:13:00 +0000] [1] [INFO] Listening at: http://0.0.0.0:80 (1)
[2021-05-20 02:13:00 +0000] [1] [INFO] Using worker: gevent
[2021-05-20 02:13:00 +0000] [9] [INFO] Booting worker with pid: 9

当然我们可以后台运行Docker镜像，执行命令：docker run -d -p 9999:80 kennethreitz/httpbin。

（3）浏览器中访问本地Httpbin服务

192.168.134.129为Linux服务器或者虚拟机的地址。

如下图所示：

这样我们就可以在本地使用Httpbin接口服务了，速度会非常的快。

4、Httpbin访问方式

Httpbin的使用方法非常简单，你只需要把请求的地址修改为httpbin.org即可。

例如GET请求：http://httpbin.org/get。

如果使用本地部署的Httpbin服务，访问：http://127.0.0.1:[自己设置的端口号]/请求路径

（请看上边第2点）

5、Httpbin常用调试接口

访问：http://httpbin.org/#/或者本地Httpbin服务http://127.0.0.1:9999/，就会出现如下界面。

页面中每个选项都可以点开，里边有对应的接口说明。

常用接口列表：

Endpoint	Descirption
/ip	返回请求者的IP地址。
/user-agent	返回传入请求的User-Agent参数。
/headers	返回传入请求的请求头参数。
/get	GET请求的提交参数。
/post	POST请求的提交参数。
/patch	PATCH请求的提交参数。
/put	PUT请求的提交参数。
/delete	DELETE请求的提交参数。

举例：

（1）返回headers信息

# 调用接口：https://httpbin.org/headers
{
  "headers": {
    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
    "Accept-Encoding": "gzip, deflate, br",
    "Accept-Language": "zh-CN,zh;q=0.9",
    "Host": "httpbin.org",
    "Upgrade-Insecure-Requests": "1",
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/63.0.3239.108 Safari/537.36",
    "X-Amzn-Trace-Id": "Root=1-5ff1a4f7-69a84fca0693b09e28d214b0"
  }
}

（2）返回访问此链接的IP地址

# 调用接口：https://httpbin.org/ip
{
  "origin": "106.35.9.12"
}

（3）返回GET请求的详细信息

# 调用接口：https://httpbin.org/get?department=1
{
  "args": {
    "department": "1"
  },
  "headers": {
    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
    "Accept-Encoding": "gzip, deflate, br",
    "Accept-Language": "zh-CN,zh;q=0.9",
    "Host": "httpbin.org",
    "Upgrade-Insecure-Requests": "1",
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.25 Safari/537.36 Core/1.70.3775.400 QQBrowser/10.6.4209.400",
    "X-Amzn-Trace-Id": "Root=1-5ff1a59b-4e514a40023721d276ae07eb"
  },
  "origin": "106.35.9.12",
  "url": "https://httpbin.org/get?department=1"
}

说明：如果需要看Httpbin服务POST如何使用，请看requests库POST请求的学习文章。

6、总结：

Httpbin服务就是干什么用的？

就是用于查看我发出去的请求到底是什么样子的。你需要查看请求中的哪一部分信息，就调用什么样的接口即可。