理解API 接口

1.定义

API (Application ProgrammingInterface)即应用程序编程接口。它是一组定义好的规则和协议,允许不同的软件应用程序之间进行通信和交互。

举个例子:可以把 API想象成是餐厅的服务员,当顾客(一个软件应用)想要获取某些菜品(数据或服务)时,服务员(API)会按照餐厅(提供API 的系统)的规定流程,将顾客的需求传达给后厨(系统内部的处理程序),然后把做好的菜品(返回的数据或执行后的结果)带给顾客。

我们也可以拆开来理解,应用程序和接口,我们可以把一个个的应用程序想象成一个个小工厂,上面的一个是deepseek的工厂用来提供回答问题服务,一个是查询天气的工厂用来提供查询天气服务。

每个工厂内部可能很复杂,但是这些我们都不需要管,我们就只需要在这个窗口,去拿我们的服务结果就行了,这个就是这两个工厂对外提供出来的接口。

知道了它的原理,我们再来了解一下做一个一键生成新闻播客的一个应用的流程应该是什么样的。

我们就需要先找一个提供热搜新闻的供应商,拿它出来的这个热搜结果,可以去发给DeepSeek,让DeepSeek总结一下写成一个播客的形式,将总结完之后的内容,以文字的形式发给一个语音模型工厂,然后产出一条你想要的语音,然后把这段语音发给用户。

2.API交易规则

我们先来看看它这个各个窗口里都会有什么,首先它得有个地址,然后像deepseek工厂这边,它这边是接收一个问题然后给你返回一个模型的回答,并且还可以指定你想让那个模型来接待你,而天气预报这边,就是接收你要查询哪个城市几号的然后给你返回一个气温。

但是,通常这些工厂不会随便谁来都给他服务,所以为了省事和方便交流,我们就需要一个送信的,就是你写好一个纸条,有一个送信的在网络世界里带着你的信给你送到窗口去,并且也会把这个工厂生产的结果,再拿这个小纸条再给你送回来,这个小纸条就是我们调用API的请求和响应,那这个送信的小哥可以理解为就是“API”。

3.HTTP协议

为了让给你送信的小哥方便拆装你的小纸条并且也是为了使各个工厂之间方便处理,所以规定了纸条都得有一个固定的格式,这个规定就是HTTP协议。

就是规定这个纸条需要有3个部分,请求首行,请求头,请求体,请求首行里面放的就是请求的地址以及请求的方式是什么,请求头里面装的就是,验证码以及说明请求体里面是什么格式等信息,请求体里面装的才是我们正式要发过去的东西,比如说我们发给DeepSeek工厂的,我们会写上我们要使用的是R1模型还是v3模型,我们的问题又是什么,然后如果我们发给天气查询工厂,我们的请求体就是城市名,日期之类的。

它响应返回是也是3部分,响应首行里面放的就是响应状态码,像OK200这种就是响应成功了,如果是404就表示你请求错地方了,响应头里面可能就包含一些响应的时间和是哪个服务器服务了你之类的,最后的响应体里面装的就是DS的回复了以及你消耗了多少TOKEN之类的。

最后我们来总结一下API的作用

1.作用数据共享与访问:例如,一个天气应用需要获取实时的天气数据。气象数据提供商就可以通过API 接口将天气数据提供给天气应用。这样,天气应用就不需要自己去收集和处理气象数据,只需要通过API请求并接收数据即可。

2.系统集成:在企业级应用中,不同的业务系统如财务系统、人力资源系统和客户关系管理系统(CRM)等需要协同工作。API接口可以让这些系统相互通信,实现数据的同步和业务流程的整合。比如,当销售部门在 CRM系统中完成一笔订单时,通过API 可以将订单信息传递给财务系统,用于生成发票和记账。