什么是API？

API

是不是经常听到程的弟弟A说“这个简单，直接调用现成的接口就可以实现了？过了一会儿，程对的弟弟乙说，“你不能这样。我们的第三方服务接口不支持。"

这时候你心里就活跃了：API 不懂什么是接口？界面能做什么？界面怎么用？我怎么知道这个函数？接口可以实现吗？不要慌，且看下文。API的全称是应用编程接口，也叫“接口”。

什么是api？

1-如果你的产品带有翻译算法，你就不必知道api是什么。Api通常用于从其他系统获取服务。

现实生活调用api的例子

以下是帮助你理解api更多细节的高级水平。为了让非技术出身的你们理解技术界的api，我不得不想到一个类似的现实生活中的例子，举一反三，迅速理解。如今，全国各地的各个街道社区都设立了便民图书馆。从便利图书馆借书就是一个很好的例子。我讲这个例子的时候，会把一些api术语带出来，大家可以很快理解。现在你需要一本参考书，但是家里没有，网上也买不到。但是，你听朋友说这本书在便利图书馆有。所以你需要打电话到便利图书馆去借这本书。(请注意，你有这个需求，你自己处理不了，所以你会使用便民图书馆提供的服务。)

什么是api的url地址

首先你得找到最近的方便库的位置，也就是api的访问地址。(所以每个api都有明确的url，也就是网络地址。)api的接口规范是什么？到了图书馆，你在门口仔细看了借书流程。

什么是api的参数

什么是get调用方式

你可以向工作人员口述上述信息。这时候你调用借书api的方式就是get方式。(get方法会把参数直接拼接在接口地址的url后面，从浏览器的地址栏就能一目了然的看到每个参数。这是一种非常暴露的方式，就像你向工作人员口述参数时，旁边的人也能听到一样。)

什么是post调用方式

也可以填写一张图书借阅信息表，交给工作人员。这时候你调用借书api的方式就是post方式。(post方法会把参数放到http请求的正文中，参数在浏览器的地址栏是看不到的。所以填表的时候有人在旁边相对安全，除了偷窥)

什么是api的返回值

只有一个api吗#API#

如果你聪明，你会立刻举一反三。图书馆提供的api必须包括借书api、还书api、借书延期API、办理长期借书证API。这些是图书馆提供的服务。每个服务都是一个api，有api调用的地址和返回值。这些都会明确写在api接口规范里。所有这些api接口规范都贴在一面巨大的墙上，叫做《开发平台手册》、《开放平台开发指南》等等。其实就是各种API的详细描述。

什么是api调用的key和secret

发现图书馆只能凭身份证借书。我该怎么办？借书证！必须先办一张借书证，每次借书都要凭卡号和密码。所以在图书馆api的参数中加入了图书馆卡的卡号和密码，卡号是key，密码是secret。所以必须先调用库的开卡api获取自己的卡号密钥和密码秘密，然后在调用其他接口时提供自己的密钥和秘密，这样库的api才能提供服务。没有卡，就没有密钥和秘密，就无法访问库的界面。

系统为什么要提供API接口？

来看一个技术世界真实的API

现在让我们来看看技术世界中的一个真实的API。https://fanyi.baidu.com/gettts? LAN=entext=hello SPD=1

你现在能理解这个API吗？

这是https://fanyi.baidu.com/gettts API的网址。你可以猜到这个API是百度提供的，用来获取翻译文本的语音！

以下是访问这个API的参数。

第一个参数的名字是lan，我们传入的值是en，于是就形成了lan=en。

第二个参数的名字是text，我们传入的值是hello，所以形成text=hello。

第三个参数的名字是spd，我们传入的值是1，所以形成了spd=1。

第一个参数告诉接口我们需要什么语言语音，第二个参数告诉接口需要什么语言语音，第三个参数告诉接口需要什么语速。这个接口的访问模式是get模式，因为所有的参数都在link中。所以你可以把这个链接直接放到浏览器里试试结果。你会马上得到一个语音文件，就是hello的英文语音。

所以，如果你的产品中需要朗读英文单词，你不可能自己拥有所有单词的发音。你该怎么办？可以通过API使用百度的这个接口服务，通过这个接口获取英语单词对应的语音文件然后播放！

总结

综上所述，API就是获取另一个系统提供的服务。API有明确的url地址、参数约定和返回值描述，这些总是被称为接口规范。根据接口规范，调用API就可以得到这个系统提供的这个服务！

题外话

很长一段时间，我的产品经理朋友都会问我一些技术知识。懂得一些技术知识已经成为产品经理目前工作的重要基础。所以我打算用通俗的白话写一些技术知识，帮助产品经理和非IT人士了解技术。如果你有什么想知道的技术知识，请在评论里留言。我希望我写的正是你需要的。

报告/反馈