【jquery Ajax】接口的学习与Postcode插件的使用

166 阅读1分钟

开启掘金成长之旅!这是我参与「掘金日新计划 · 12 月更文挑战」的第13天,点击查看活动详情

 接口

        接口的概念

使用Ajax请求数据时,被请求的url地址,就叫做数据接口(接口),同时,每个接口必须有请求方式,

        分析接口的请求过程

                通过GET方式请求接口的过程

​编辑

                  通过post方式请求接口的过程

​编辑

         接口测试工具

                什么是接口测试工具

为了验证接口能否被正常访问,我们常常需要使用接口测试工具,来对数据接口进行检测。

接口测试工具能让我们在不写任何代码的情况下,对接口进行调用和测试。

                 安装Postcode

postman安装包臃肿,而且 Postman 还收费,免费版本也不支持一些功能。关键有些功能完全用不到,还占地方,推荐一个vscode 插件,叫做postcode。

​编辑

安装失败的话,会提示手动安装,手动安装再导入也可以,

 ​编辑

                使用postcode测试get接口

步骤

  1.  选择请求的方式
  2. 填写请求的URL地址
  3. 填写请求的参数
  4. 点击Send按钮发起GET请求
  5. 查看服务器响应的结果。

​编辑

                 使用postcode测试post接口

步骤

  1. 选择请求的方式
  2. 填写请求的URL地址
  3. 选择Body面板并勾选数据格式
  4. 填写要发送到服务器的数据
  5. 点击Send按钮发起POST请求
  6. 查看结果

 ​编辑

 提交数据 要选择body里的​编辑格式进行提交。

         接口文档

                什么是接口文档

接口文档,顾名思义就是接口的说明文档,它是我们调用接口的依据,好的接口文档包含了对接口URL,参数以及输出内容的说明,我们参照接口文档就能方便的知道接口的作用,以及接口如何进行调用。

                接口文档的组成部分

接口文档可以包含很多信息,也可以按需进行精简,不过,一个合格的接口文档,应该包含以下六项内容,从而为接口的调用提供依据。

  1. 接口名称:用来标识各个接口的简单说明,如何登录接口,获取图书列表接口等
  2. 接口URL: 接口的调用地址。
  3. 调用方式: 接口的调用方式 如GET或POST。
  4. 参数格式:接口需要传递的参数,每个参数必须包含参数名称,参数类型,是否必选,参数说明这四项内容。
  5. 响应格式:接口的返回值的详细描述,一般包含数据名称,数据类型,说明三项内容。
  6. 返回示例(可选):通过对象的形式,列举服务器返回数据的结构。

                 接口文档示例

 ​编辑

响应格式

​编辑

 返回示例

​编辑