API接口,其实就是个插座!

简介: 如果把互联网比喻为信息高速公路,那么既然是高速公路,就得有交通规则对不对?不然你开拖拉机的、和开大卡车的都在一条路上飙车,很容易堵车是不是?因此信息高速公路的交通规则中,就有一条特别规定了,开拖拉机的和开卡车分别应该走什么车道。开拖拉机的运载的货物相对比较少,也很容易看出来运载的是什么货物,因此建议走get车道,虽然路窄一点,但好在过关卡的时候不用下车检查。

借助生活中熟悉的事物来理解接口,从插座到接口,你对接口的理解是不是更形象生动了?产品经理在日常的工作中,会经常与技术沟通。例如,在需求评审会上,开发说,你这个需求太复杂,光接口就十几个;又比如技术说联调接口,接口的响应时间等——这些都关于接口,如果产品经理不懂接口,显然就不能跟技术愉快地沟通了。这篇文章就来讲解“接口”这个玩意儿。

一、生活中的“接口”

先来看看接口的定义:API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,包括接口地址、传入参数和返回参数,目的是实现系统之间的相互通信。嗯,太复杂,太抽象了。认知心理学上讲,学习新事物有个技巧:将陌生的事物与大脑中熟悉的事物相联系,这样便于理解新的事物。那生活中有没有类似的概念呢?在日常生活中,两个实物之间进行连接的部分成为接口。

没错,插座就是一个接口!!!手机的插座、风扇的插座、台灯的插座,都是统一标准的二插,只要找到插座,就可以充电!所有的电器只要符合接口规范,便可以通过接口获得电(相应地,所有系统只要符合另一个系统的接口规范,便可以通过接口获取数据)。

举一个具体的例子:

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

二、技术说的“接口”

而技术所说的接口可以理解为:基于需求为了获得某些数据,正常状态下传入请求参数,会收到该数据范围内的返回参数。再来看一个产品中的例子,钉钉开放平台所提供的获取员工花名册字段信息的接口(如下图所示):接下来,本文将从接口的四大组成“接口地址、请求方法、请求参数、返回内容和系统”来讲解接口。

  1. 请求方式:get/post

如果把互联网比喻为信息高速公路,那么既然是高速公路,就得有交通规则对不对?不然你开拖拉机的、和开大卡车的都在一条路上飙车,很容易堵车是不是?因此信息高速公路的交通规则中,就有一条特别规定了,开拖拉机的和开卡车分别应该走什么车道。开拖拉机的运载的货物相对比较少,也很容易看出来运载的是什么货物,因此建议走get车道,虽然路窄一点,但好在过关卡的时候不用下车检查。

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

  1. 请求地址

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

  1. 参数说明

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

  1. 返回内容

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

三、接口的性能

  1. 接口响应时间

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

  1. 并发数

指同时访问服务器站点的连接数。可以进行简单估算,如果响应时间<200ms,1s=1000ms,1000/200=5,那么1个线程,秒并发>5,如果有20个线程,那秒并发可以超过100。响应时间越短,多线程并发数越高,接口性能越好。不是所有的业务场景都需要“最好”的性能,满足业务场景即可。

  1. 进程和线程

一个程序有多个进程,一个进程有多个线程。对于操作系统来说,一个任务就是一个进程。比如,打开一个浏览器就是启动一个浏览器进程,打开一个记事本就启动了一个记事本进程,打开两个记事本就启动了两个记事本进程,打开一个Word就启动了一个Word进程。有些进程还不止同时干一件事,比如Word,它可以同时进行打字、拼写检查、打印等事情。

在一个进程内部,要同时干多件事,就需要同时运行多个“子任务”,我们把进程内的这些“子任务”称为线程。

四、小结

可以发现,理解好接口,可以帮助产品经理:更加理解各个系统之间的数据是如何流转的,在需求设计阶段考虑会更加全面、严谨。虽然不懂如何实现,但能大概估摸出开发总体工作量,在安排项目计划时会考虑到接口的难易程度。

数据与用户行为相联系,接口实现系统之间的数据交互,从功能的角度讲,便是功能决定接口,接口反作用于功能。

相关文章
|
9月前
|
人工智能 自然语言处理 测试技术
Apipost智能搜索:只需用业务语言描述需求,就能精准定位目标接口,API 搜索的下一代形态!
在大型项目中,API 数量庞大、命名不一,导致“找接口”耗时费力。传统工具依赖关键词搜索,难以应对语义模糊或命名不规范的场景。Apipost AI 智能搜索功能,支持自然语言查询,如“和用户登录有关的接口”,系统可理解语义并精准匹配目标接口。无论是新人上手、模糊查找还是批量定位,都能大幅提升检索效率,降低协作成本。从关键词到语义理解,智能搜索让开发者少花时间找接口,多专注核心开发,真正实现高效协作。
|
9月前
|
缓存 监控 前端开发
顺企网 API 开发实战:搜索 / 详情接口从 0 到 1 落地(附 Elasticsearch 优化 + 错误速查)
企业API开发常陷参数、缓存、错误处理三大坑?本指南拆解顺企网双接口全流程,涵盖搜索优化、签名验证、限流应对,附可复用代码与错误速查表,助你2小时高效搞定开发,提升响应速度与稳定性。
|
9月前
|
JSON 算法 API
Python采集淘宝商品评论API接口及JSON数据返回全程指南
Python采集淘宝商品评论API接口及JSON数据返回全程指南
|
9月前
|
存储 缓存 算法
亚马逊 SP-API 深度开发:关键字搜索接口的购物意图挖掘与合规竞品分析
本文深度解析亚马逊SP-API关键字搜索接口的合规调用与商业应用,涵盖意图识别、竞品分析、性能优化全链路。通过COSMO算法解析用户购物意图,结合合规技术方案提升关键词转化率,助力卖家实现数据驱动决策,安全高效优化运营。
|
9月前
|
JSON API 数据安全/隐私保护
Python采集淘宝拍立淘按图搜索API接口及JSON数据返回全流程指南
通过以上流程,可实现淘宝拍立淘按图搜索的完整调用链路,并获取结构化的JSON商品数据,支撑电商比价、智能推荐等业务场景。
|
10月前
|
人工智能 运维 监控
阿里云 API 聚合实战:破解接口碎片化难题,3 类场景方案让业务响应提速 60%
API聚合破解接口碎片化困局,助力开发者降本增效。通过统一中间层整合微服务、第三方接口与AI模型,实现调用次数减少60%、响应提速70%。阿里云实测:APISIX+函数计算+ARMS监控组合,支撑百万级并发,故障定位效率提升90%。
750 0
|
10月前
|
JSON 前端开发 API
如何调用体育数据足篮接口API
本文介绍如何调用体育数据API:首先选择可靠服务商并注册获取密钥,接着阅读文档了解基础URL、端点、参数及请求头,然后使用Python等语言发送请求、解析JSON数据,最后将数据应用于Web、App或分析场景,同时注意密钥安全、速率限制与错误处理。
1080 152
|
10月前
|
JSON 自然语言处理 监控
淘宝关键词搜索与商品详情API接口(JSON数据返回)
通过商品ID(num_iid)获取商品全量信息,包括SKU规格、库存、促销活动、卖家信息、详情页HTML等。
|
10月前
|
人工智能 API 监控
告别多接口拼凑!阿里云 API 模型聚合实现技术能力协同跃迁
API聚合整合400+国内外AI模型,统一接口、屏蔽差异,降低开发与维护成本,提升效率与系统稳定性,助力开发者高效应对多API调用困境。
1123 0
|
10月前
|
人工智能 供应链 API
淘宝API商品详情接口全解析:从基础数据到深度挖掘
淘宝API商品详情接口不仅提供基础数据,更通过深度挖掘实现从数据到洞察的跨越。开发者需结合业务场景选择合适分析方法,利用AI标签、区块链溯源等新技术,最终实现数据驱动的电商业务创新。