如何对接接口?

发布时间 2023-07-14 15:51:40作者: 牵牛找花

我们在开发系统中不可避免是需要和第三方接口做对接和联调,那么如何快速高质量完成接口对接呢?需要掌握那些方法和技巧呢?接下来我从以下几方面入手帮助大家学习如何对接接口。

1. 理解什么是接口  2. http的请求过程  3. 请求工具的使用

 

一、什么是接口?

  如果你去直接百度“什么接口?”,那么你搜到的大概率都是一些专业的偏软件层面的解释,看了半天似懂非懂。其实站在对接方我们可以这么去理解接口,接口就是一个制定了指定规则的获取信息的渠道。这个渠道你可以把它想象成是一个商店,通过这个商店只要根据其规则就可以拿到你想要的东西。

 

二、HTTP的请求过程

  为啥要讲到http呢?因为接口对接过程中最重要的就是http请求。还是以商店为例,http的请求过程就好比你在网上购物。例如你要用一个接口获取用户信息,那么这个信息该怎样才能获取到呢?

  这里我先放一个专业的讲解链接,大家可以看这个博主的讲解:https://zhuanlan.zhihu.com/p/362121872

  其实我还是举个例子来说这个过程吧。整个请求过程中主要由客户端(小明)、浏览器(网店)、解析服务器(客服)、服务器(仓库)、网络(电话)这几个部分组成,假如现在请求一个接口,整个其实就好比要买一双篮球鞋,小明首先找到网点,跟客服说他要买一双白色的篮球鞋,客服根据小明的要求找到了这双鞋所在的仓库,然后打电话给仓库让仓库把篮球鞋拿到网店里来,小明则在网店买到了他想要的百色球鞋。其实这个过程就是网络http请求数据的一个过程。假如没有篮球鞋,客服会返回404码。如果是仓库里发生了错误那么客服会返回500码。

  那么这个过程中要注意些什么呢?

  (1) 域名

  域名是必不可少的。以百度为例,百度的首页的接口就是baidu.com,它是http方式和https都可以的,这个也是要看第三方提供了那种请求方式。

  

  (2) 请求方式

  请求方式有很多种,POST、GET是我们最常见的请求方式,请求方式不同其携带参数的方式也不相同,而且携带参数数据大小也不一样。有的第三方会根据请求方式的不同来定义接口的作用,比如有的就会把GET请求专门用作获取数据的接口,把POST请求用作操作类的接口,当然也有只用一种的。像我们的浏览器中访问的网页一般都是GET的请求方式。

  (3) 请求头

  请求头中包含的数据直接决定了你的姿势能否成功获取到数据。比如接口会根据你的token验证权限,根据参数决定给你返回什么样子的数据。

  

  请求头一般包括以下几个信息

  1.接口地址(域名)

  2. 请求方式

  3. 浏览器的基础信息

  4. 参数

    服务器会返回响应行,包括协议版本和状态码。比如 200 表示请求成功,如果没有找到页面,则会返回404,更多的返回码可以参考 https://zhuanlan.zhihu.com/p/53165474      

  

三、 请求工具的使用

  常用的测试接口的工具都可以对接接口,我常用的工具有Postman、Apifox等,以Postman为例