接口,原来就是个插座~



产品经理在日常的工作中会经常与技术沟通,例如在需求评审会上,开发说,你这个需求太复杂,光接口就十几个,又比如技术说联调接口,接口的响应时间等等,这些都关于接口,如果产品经理不懂接口,显然就不能跟技术愉快地沟通了。这篇文章就来讲解“接口”这个玩意儿。




生活中的“接口”



先来看看接口的定义:

 

API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,包括接口地址、传入参数和返回参数。API的目的是实现系统之间的相互通信

 

嗯,太复杂,太抽象了。

 

认知心理学上讲学习新事物有个技巧,将陌生的事物与大脑中熟悉的事物相联系,这样便于理解新的事物。那生活中又没类似的概念呢?

 

在日常生活中,两个实物之间进行连接的部分成为接口。没错,插座就是一个接口!!!手机的插座、风扇的插座、台灯的插座,都是统一标准的二插,只要找到插座,就可以充电!





所有的电器只要符合接口规范,便可以通过接口获得电。(相应地,所有系统只要符合另一个系统的接口规范,便可以通过接口获取数据)


举一个具体的例子:

 

小明的手机没电了,需要充电,怎么办?小明需要找到电源插座,然后通过充电器与手机相连进行充电。如下图所示:




技术说的“接口”



而技术所说的接口可以理解为:基于需求为了获得某些数据,正常状态下传入请求参数,会收到该数据范围内的返回参数。

 

再来看一个产品中的例子——钉钉开放平台所提供的获取员工花名册字段信息的接口(如下图所示),加深一下印象吧~




将从接口的四大组成接口地址请求方法请求参数返回内容和系统讲解接口:




请求方式:get/post


 

如果把互联网比喻为信息高速公路,那么既然是高速公路,就得有交通规则对不对。不然你开拖拉机的、和开大卡车的都在一条路上飙车,很容易堵车是不是。因此信息高速公路的交通规则中,就有一条特别规定了,开拖拉机的和开卡车分别应该走什么车道。


开拖拉机的运载的货物相对比较少,也很容易看出来运载的是什么货物,因此建议走get车道,虽然路窄一点但好在过关卡的时候不用下车检查。


大卡车运载的货物比较多还比较隐蔽,因此走post车道



1是一个get请求,他的参数是拼接在url(query string)里的。


 

 

 

图二是一个post请求,它的参数是在request body(请求体)中的,以键值对的形式传递参数。

 

 




▌请求地址


顾名思义就是接口的地址,以网址的形式展现,你通过发送请求给这个网址来对接口进行交互操作。

 


▌参数说明


即传输参数的时候要带的一些参数,一般文档中会用表格的形式清晰的说明。当我向接口发送携带请求参数的请求时,都要携带什么字段,规则是什么。如下图:




▌返回内容


返回内容一般会以json或是XML的形式返回。


(XML 和JSON是两种完全不同的数据表达方式。他们分别采用完全不同格式将原始数据转换成XML或者JOSN格式数据,再借用货车与高速公路的例子,XML或JSON是车装载的货物






像上面贴出来的这种接口,还是比较好阅读的。如果我们发送userid_listfield_filter_list,就是员工userid列表和花名册字段列表,接口就返回给我们errcode返回码以及errmsg返回码的文本描述,提示我们是否返回成功。


假若成功便会返回如下的花名册字段信息:






接口的类型




▌同步接口


同步接口A系统请求B系统接口之后,必须获得B系统接口的响应后才会执行下一步操作。


例如:登录操作的时候调用第三方平台接口(如微信)进行登录,需要跳转到微信进行验证并返回验证结果后,才能登录成功。



▌异步接口


异步接口A系统请求B系统接口之后,不需要等待源系统返回结果就可以进行下一步操作。


例如:在滴滴打车之后,司机点击结束行程后,不需要等待银行付款成功之后再开始下一个订单。因为此时滴滴已经验证过司机、乘客的银行账户或者支付宝账户,确认了双方交易的合法性就可以结束订单。这时,我们看到的是我们已经付款成功(其实银行可能还没扣款),而滴滴后台会将这笔交易流水传给银行,在银行验证后再进行扣款、付款操作。





接口的性能



▌接口响应时间


从请求端发送一个请求开始,到接收到响应结果所经历的时间。



▌并发数


指同时访问服务器站点的连接数。

可以进行简单估算,如果响应时间<200ms,1s=1000ms,1000/200=5,那么1个线程,秒并发>5,如果有20个线程,那秒并发可以超过100。


响应时间越短,多线程并发数越高,接口性能越好。

不是所有的业务场景都需要“最好”的性能,满足业务场景即可。



▌进程和线程


一个程序有多个进程,一个进程有多个线程。

对于操作系统来说,一个任务就是一个进程,比如打开一个浏览器就是启动一个浏览器进程,打开一个记事本就启动了一个记事本进程,打开两个记事本就启动了两个记事本进程,打开一个Word就启动了一个Word进程。

有些进程还不止同时干一件事,比如Word,它可以同时进行打字、拼写检查、打印等事情。在一个进程内部,要同时干多件事,就需要同时运行多个“子任务”,我们把进程内的这些“子任务”称为线程




小结



可以发现,理解好接口,可以帮助产品经理:


1. 更加理解了各个系统之间的数据是如何流转的,在需求设计阶段考虑会更加全面、严谨。


2. 虽然不懂如何实现,但能大概估摸出开发总体工作量,在安排项目计划时能够考虑到与周边系统联调的时间,计划安排才会更加合理;


最后用一句话总结一下,数据与用户行为相联系,接口实现系统之间的数据交互,从功能的角度讲,便是功能决定接口,接口反作用于功能~


更多产品和设计的分享,关注微信公众号:大道产品





金莱克
产品经历 · 杭漫文化