# 2.最简单的接口长什么样




接口测试由浅入深的学习才可以尽量减少挫败感，避免从入门到放弃的悲剧。

从入门到放弃其实最可惜，毕竟花了那么多时间去学习，最后放弃掉，花费掉的青春就一去不复返了。

### 获取资源的接口

我们先来看一下获取资源的接口。

[v2ex](https://www.v2ex.com/)是一个讨论区，也就是大家常说的论坛，这是一个小众的讨论区，基本上只有程序员光顾。

[v2ex](https://www.v2ex.com/)里有很多的节点，节点可以理解成是讨论板块，比如[这个板块](https://www.v2ex.com/go/python)就是讨论python技术的。

v2ex提供了一些接口，可以让我们去获取v2ex站点的一些资源，比如讨论区的信息，热门帖子等，这很符合互联网的分享精神。

v2ex的api描述页面在[这里](https://www.v2ex.com/p/7v9TEc53), 文档相对简洁，基本上是给看得懂的人看的。

我们仔细研究一下获取节点信息的接口。这个接口可以获取指定节点的名字，简介，URL 及头像图片的地址。

下面是这个接口的具体描述

```
获得指定节点的名字，简介，URL 及头像图片的地址。

https://www.v2ex.com/api/nodes/show.json

Method: GET
Authentication: None
接受参数：

name: 节点名（V2EX 的节点名全是半角英文或者数字）
例如：

https://www.v2ex.com/api/nodes/show.json?name=python
```

我们从这个接口文档里可以获得哪些信息呢？换一句话说，我们能不能通过接口文档去了解这个接口是做什么的呢？

### 接口分析

从上面的描述里，我们可以得到下面一些信息

* 接口的协议：https协议，也就是更安全版本的http协议；
* 请求的方法：http协议里定义了一些请求的方法或者叫动词，这些方法和动词可以进一步定义请求的目的，比如是获取资源还是创建资源等；上面的例子里，请求方法是GET;
* 请求参数：http协议里规定了请求的时候可以传递一些参数给服务端，这些参数可以更加具体的描述资源，比如获取多少个资源，这个资源的名字是什么。上面的例子里，我们可以传递name参数指定资源的名称，比如获取名字叫python的资源，这里资源就是节点；
* 鉴权：简单来说，就是要不要登录，很显然，上面的接口是不需要登录的

合起来，我们应该可以得到这样的信息：

当我们发送:`https://www.v2ex.com/api/nodes/show.json?name=python`，这个http的get请求给服务器之后，服务器应该返回相应的资源，那么这时候就需要探讨一下

* 什么是请求: [视频在这里](https://ke.qq.com/webcourse/index.html#course_id=229839&term_id=100271202&taid=1419130209272271&vid=b1419h42e0i)

* 什么是响应: [视频在这里](https://ke.qq.com/webcourse/index.html#course_id=229839&term_id=100271202&taid=1419134504239567&vid=m1419qedwye)

### 如何查看接口的返回

我们现在已经知道了这个接口的情况了，如何查看接口的返回呢？

我们可以使用一些辅助工具帮助我们进行接口的调用，查看接口返回，最简单的跨平台调试工具推荐使用[postman](https://www.getpostman.com/)




原始封面

![课程图片](https://images.unsplash.com/photo-1507831273071-5db7707d651b?w=300)