关于 API

Posted 2020-10-11 roadone

1.

API（Application Programming Interface,应用程序编程接口）是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。

 

2.

简单来说就是函数。
比如你写了一个库，
里面有很多函数，
如果别人要使用你这个库，
但是并不知道每个函数内部是怎么实现的。
使用的人也就只是知道这个函数的入口参数和返回值或者这个函数是做什么的。
对于用户来说 ，
你的这些函数就是API。
API(Application Programming Interface应用程序编程接口) 是一些预先定义好的函数，
目的是提供应用程序以及开发人员基于某软件或硬件得以访问一组例程的能力。

作者：爱要不留余力
链接：https://www.zhihu.com/question/38594466/answer/147066011
来源：知乎
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

 

3.

给你举个特别容易理解的例子

有一天，轮子哥写了一个专门抓取知乎小黄文的AI，而他每天都会查阅小黄文列表并且点赞。恰好你也是小黄文爱好者，那么轮子哥的账号对你来说就是API接口，你要做的唯一事情就是关注轮子哥账号，每天只需要查阅轮子哥的动态就能看到小黄文，但是不用关心轮子哥到底是用什么方法找到这么多小黄文的。

作者：彭天浩
来源：知乎
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

 

4.

 

通俗的讲API 就是前后端间的联通。假象你去一家餐厅，桌子上有一份菜单，厨房能为你提供菜单上的菜式。那么我们还缺少一个能和后厨联系的人，所以服务员MM就是去告诉后厨你选的菜，再将菜带回到你的桌子上。MM带着你的request去告诉system，然后将response 带回给你。

来看一个API案例，airline system ,你订机票，你将你的航程提交，会访问网站的database,来看你选择的日期，座位是否是可选。但如果你不是在他的网站上订机票，你是在一个汇总不同的航班信息的online travel service 上，那么这个service 调用了 前面airline system 的API 。这个接口就像上面例子的服务员MM，带着你的要求去airline system 上 收集信息 ，然后带回到online travel service 上 。所以你就把它想象成你的服务员MM在前后端间交付数据，创建联系。

作者：我要干掉太阳
来源：知乎
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

 

5.

 

作者：优达学城（Udacity）

我最近跟一位 Techstars 的创业家聊天时，问了她一个问题：“你们公司的 API 是什么？” 这听起来是个挺奇怪的问题，但其实并不是。 

每家创业公司都有一个面向外界接口。有些接口非常简单，比如说 Google，你只要输入关键词搜索就好；有些接口复杂一些，比如在 Amazon 上买东西，你可以浏览商品、搜索商品、添加商品到购物车、下订单、请求退款，等等。

 即使你不是工程师或是产品经理，思考你的公司会向外界提供什么 API 也是很有帮助的。这能够使你对自己的业务是什么以及为什么有更加清晰的认识。

 API 思维帮助你保持最简和清晰。

 API 是什么？

 API（Application Programming Interface）即应用程序接口。你可以认为 API 是一个软件组件或是一个 Web 服务与外界进行的交互的接口。而我们在这里要谈论的，是作为一家公司如何跟外界进行交互。从另一个角度来说，API 是一套协议，规定了我们与外界的沟通方式：如何发送请求和接收响应。

  

让我们拿网站上常见的复选框（checkbox）作为例子。复选框的接口允许你选择或者取消选择它。

 

/check -- causes checkbox to be checked
/uncheck -- causes checkbox to be unchecked

 

再举个例子，Digital Ocean（VPS 供应商）提供的一次性启动 10 个服务器的 API 可能长成这样：

 

/launchServers?numServers=10 -- starts running servers in the cloud.

 

在这个例子中，launchServers 命令允许用户指定要启动的服务器的数量。绝大多数服务都支持这样的自定参数，一是更灵活，二是复用性好。要是启动 10 个服务器和 20 个服务器有两个不同的命令，那就太蠢了，因为它们本质上是一样的。

 

商业API 又是什么？

 

设计你的商业 API 时，可以从你的业务有哪些关键概念入手来考虑相关的命令，这样会比较方便。思考：你的用户们可以做哪些事情？下面是一些简单的例子：

 

http://google.com/search?term=techstars

http://amazon.com/browse?category=books

http://amazon.com/buy?bookId=b&customerId=c

http://uber.com/orderCar?location=loc&customerId=c

http://twitter.com/postTweet?text=t&userId=u

http://facebook.com/friend?userId=u&friendId=f

 

现在的服务大多都运行在云上，通过 HTTP 协议与外界交互。这不是太直观，因为我们和用户看到的都是界面美观友好的 APP。但实际通过 HTTP 传输的是这些命令。它们非常重要，因为这些最底层和直接的接口最终决定了你的用户能够如何使用你的服务。通过这样的思考，我们才能透过人机界面理清业务的核心。

 

如何设计你的商业API？

 

现在让我们把注意力集中到你的公司。开始创业时，你有一大堆事情要做：寻找和理解创始人与市场之间的契合，跟用户沟通，思考你们独有的见解和优势，市场策略，等等等等。除此以外，设计商业 API 也是你在早期就应该做的事情之一。

 

花点时间研究 HTTP 协议吧（真的不难）！在开发你的 MVP（Minimum Viable Product，最简可行产品）之前，你就要把 API 设计好了。

 

设计 API 可以帮助你理清自己的业务。你会在这个过程中决定 MVP 中会包含哪些东西，不包含哪些东西。你会给某些命令更高的优先级。最后，拿一张纸把设计好的 API 写下来，你就知道自己是提供了太多还是太少。

 

尽可能地将你的 API 设计得简单和优雅。不要考虑应该添加什么，而是想想应该去掉什么。

 

有了基础的 API 以后，跟客户和团队沟通起来就方便多了。这将为你接下来打造 MVP 提供坚实的基础。

 

当你设计出令人满意的 API 之后，就去实现它吧。一个一个让原始 API 能通过 HTTP 被访问。没错，你现在还不需要花哨的界面。在实现的过程中，你会对自己的业务有更深的了解。

 

随着业务增长，升级你的 API

 

随着你的业务进化和增长，你的 API 也需要作出改变。持续地更新和改善它。可以扩充它，但要 “矜持” 一点。最伟大的公司都有着简单的 API。

 

想一下 Google，它提供了一个非常简单的接口，但内部的工作原理是无比复杂的。类似地，乔布斯总是驱动 Apple 公司来不断简化用户界面。Apple 的产品往往通过简单的界面来隐藏背后的工程复杂度和独创性。

 

“你会希望你的业务越简单越好，隐藏在接口背后的服务越有价值越好。”

 

在业务增长的过程中，一些子业务可能会演化出它们自己的 API。你可能会有公共接口和内部接口。这时将接口保持得简单而整洁就开始凸显价值了。不断鞭策自己去实现和使用简单的接口。

 

“你的业务本身永远是你的 API 的第一个也是最大的用户。”

 

通常伴随着业务增长，用户访问你的服务的方式也会越来越多。你可能同时有桌面版应用和移动端应用，短消息服务，机器人，ios 和 安卓应用，等等。这些都是你的 API 的用户，也是你的业务的用户。

 

我们生活在一个云服务和自动化的时代。每家互联网巨头，Google、Amazon、Facebook 等，都为他们的服务提供了 API。而在未来，所有的服务都将在一个图形界面以外拥有编程接口。随着人工智能和自动化逐渐进入我们的世界，越来越多的请求和访问会在这些云服务和 API 之间发生。如果你打算创业，为了准备如此激动人心的未来，你可以从思考和实现自己的 API 做起。

 

本文由优达学城（Udacity）编译，翻译：章凌豪，原文参考自 http://alexiskold.net。