访问和使用API的终极指南

您可能不知道API是做什么的。你可能不知道它代表什么。但是日常的api正在幕后工作，为您提供更丰富的数字体验。你在网上购买的电影票，你在Facebook上分享的博客食谱，以及你在Expedia上预订的廉价机票，都要感谢api。

通过帮助从一个设备到下一个设备提供无缝集成的用户体验，API提供了丰富的商机。在讨论API如何促进您的业务之前，让我们仔细看看什么是API，以及为什么它们会如此迅速地扩散。

这对最终用户（和第三方开发raybetapp人员来说，这是一个很好的消息，但我们会在一分钟内到达它们）。因为API做了所有繁重的升降，所以数字经验几乎毫不费力。

现实世界的API的例子

比如说你想看最新的卖座电影。你的第一步可能是在像Fandango这样的在线票务网站上搜索它在何时何地播放。

输入邮政编码并选择日期后，单击“开始”，瞧，几秒钟内就会出现附近影院的演出时间列表。以下是它对最终用户的外观。

图片来源

虽然整个时间都留在粉阵的网站上，但在工作中有多种应用来进行搜索。单击“Go”时，该站点使用API​​来请求访问每个剧院的数据库。

这被称为API调用．然后，这些api检索所请求的信息，以便Fandango的站点为您显示最相关的结果。

随着对这种轻松用户体验的期望不断增长，越来越多的公司希望api在更短的时间内为消费者提供更多的价值。通过利用api访问其他公司的数据、代码、软件或服务，您可以在节省时间和金钱raybet电子竞技的同时扩展自己产品的功能。雷竞技苹果下载官方版这不仅对于满足和预测消费者日益复杂的需求，而且对于在市场中保持敏捷是至关重要的。

如果服务器(提供资源的应用程序)能够执行客户机(发出请求的应用程序)所请求的操作，则API将带回所需的资源或状态代码，大致转化为任务完成！如果服务器无法执行客户端请求的操作（可能客户端请求的资源不存在或没有访问权限），则API将返回一条错误消息。

以这种方式控制对服务器的访问至关重要。API只提供外部用户可以使用的数据，而不是提供程序的所有信息或代码。

API呼叫

API调用是客户端应用程序向服务器API提交请求的过程。API调用还包括提交请求后发生的所有事情，包括当API从服务器检索信息并将其返回给客户机时。

请求方法

大多数客户端希望服务器执行基本功能。这些请求可以写成url，这样客户端和服务器之间的通信就由规则来决定超文本传输协议（HTTP）．对服务器的四种最基本的请求方法是:

• 获取：检索资源
• POST:创建一个新资源
• PUT：编辑或更新现有资源
• 删除：删除资源

仍然困惑？让我们尝试一个类比。如何将API工作与在餐厅订购食物时，您将在其中，食客代表客户端，服务员代表API，并且厨师代表服务器。您查看菜单，选择您想要的膳食，并与服务员订购。服务员将您的要求带给厨师。厨师在它上执行。然后，服务员带给你你的饭，你享受它的享受更好，因为没有必要自己做到这一点。

图片来源

但是，让我们说太多的客人在餐厅出现，并且没有足够的空间来容纳它们。让我们说这在餐厅的流行程度越来越多，这一直在发生。然后怎样呢？这就是API键进入的地方。

什么是API密钥?

API键是用于对API进行身份验证调用的唯一标识符。该密钥由一串字母和数字组成，标识客户端（请记住这是提出请求的应用程序或网站）。关键可以根据客户端的访问权限授予或拒绝该请求，并跟踪用于使用和计费目的所做的请求数。

虽然不是安全的身份验证令牌，这种方法比基本身份验证有一些优势，基本身份验证只需要用户名和密码。

通过限制仅对那些使用密钥的访问，公司可以控制对其API的调用数量，并确保只有特定的、受信任的客户组raybet电子竞技可以访问其服务器资源。reybet雷竞技下载

继续上面的示例，将API键想像成一个预订，而API则想像成一个独家餐厅。通过强制要求顾客必须预订餐厅的食物，你可以保持餐厅的容量，这样厨房就可以充分有效地为每一位客人服务。类似地，通过只允许具有API密钥的客户端访问和使用通过API提供的资源，您可以确保您的软件被安全使用，并可以处理传入的请求数量。reybet雷竞技下载雷竞技苹果下载官方版

api的用途是什么?

一个更好的问题可能是什么是apis不用于。想要在你的电子商务应用程序中嵌入Instagram照片?有一个API的。想要在你的旅游博客上即时访问数千家酒店?有一个API的。想要在你的星球大战同人小说网站吗?如果你相信的话，有一个API为它。

一般来说，api的商业应用包括:

• 数据共享:任何时候一个程序需要从第三方获取数据(例如，一个旅行应用程序从航空公司收集航班时间，一个电子商务网站从支付处理器获取你的支付信息)，数据都可以通过API共享。
• 应用程序集成:当两个数字应用程序协同工作时，例如HubSpot和Gmail，就很可能涉及到API。
• 嵌入式内容：嵌入不被同一公司作为网站本身托管的内容 - 像YouTube视频或谷歌分析等第三方脚本 - 将嵌入式内容的所有者提出以检索它的请求raybet电子竞技．
• 内部系统:api不仅仅用于外部共享数据。企业经常将他们的软件基础架构划分为更小的组件，这些组件通过api相互通雷竞技苹果下载官方版信，就像microservice架构．

这些示例达到了公司使用API​​的一些最常见的原因。下面，我们深入了解API及其业务应用程序的其他示例。

API示例

在没有搜索API市场，甚至知道API的太多，你可能听说过几个。下面我们将在几个示例中更仔细地看出，因此您可以了解通过它们提供的信息和功能。

Twitter api

如果你为一个喜欢Twitter的品牌，你可以使用社交媒体平台的api来推动用户对你网站的参与。

Twitter有一个完整的平台，提供API，允许您通过Twitter的大量档案挖掘。你可以使用Twitter api找到旧推文，在您的网站或应用程序中嵌入推文和时间表，以编程方式创建和管理广告活动，过滤和流鸣叫，通过直接留言提供个性化的客户服务，订阅超过15个帐户的实时活动通过人则， 和更多。

还有一吨技术资源和工具reybet雷竞技下载可帮助您充分利用其全球通信网络的潜力。

Instagram api

Instagram的平台提供了一系列api帮助您的业务与内容发布，指标和分析等等。

一个潜在的用途是在你的应用程序中嵌入用户生成的Instagram照片。用户生成的内容，有时简称为UGC，是一种强大的形式社会证明这可能导致转换。

开发人员插入该平台，构建针对三个群体的应用程序和服务：希望与第三方应用程序共享自己内容的个人；需要了解和管理其受众和媒体权利的品牌和广告商；广播公司和出版商希望发现内容并获得媒体的数字版权，或以适当的归属分享。

YouTube api

YouTube api允许您添加一个功能到您的网站或应用程序，并访问YouTube的广泛的视频库。

让我们走过几个可能想要使用众多YouTube API之一的原因：直接在您的应用程序中播放视频;让用户搜索内容，上传视频，并创建和管理播放列表;深入了解用户如何与您的视频和频道进行交互;安排直播;以及更多。你需要获取YouTube API密钥释放其潜力。

HubSpot的api

HubSpot的平台吸引了三种主要需求的企业:那些希望构建一个应用程序并将其展示给成千上万的潜在用户的企业，那些希望在自己的应用程序和HubSpot的应用程序之间创建自定义集成的企业，以及那些希望构建或扩展自己网站功能的企业。

从不同的交易软件中收集数据，存储联系人，在一个CRM中使用第三方工具和定制应用程序，这些雷竞技苹果下载官方版只是HubSpot api可以帮助你的业务的几种方式。

Spotify Web api

如果你在音乐行业，你可能想要使用Spotify Web api为你的网站或应用程序添加音乐播放器功能。

使用Spotify的大量api，您可以完全访问Spotify数据目录，包括专辑、音乐艺术家和曲目。要检索用户相关数据（如私人播放列表），用户必须授权您的应用程序访问其Spotify帐户。

功能性几乎与您在本机Spotify平台上找到的内容相同。例如，使用浏览API，您的用户可以访问流派，类别，新版本和播放列表推荐。Spotify还提供剧集，关注，库和播放列表API。

卡住了吗?Spotify发布了一份榜单示例应用程序因此，您可以看到他们的API在过去是如何使用的。

谷歌地图api

谷歌Maps api对于任何创建基于位置的应用程序的人来说都是一个必不可少的工具。例如，如果你正在创建一个房地产应用程序，你可以使用谷歌Maps api来包含该房产的街景。

谷歌平台有一个扩展的api库，可以无限使用。希望允许用户请求方向?在你的网站上包括地点如何?谷歌根据使用情况和平台(网页、iOS或Android)划分了API，所以一定要为你的项目选择正确的API。

和这里列出的大多数例子一样，这些api是付费的根据月度使用。他们提供的高水平使它们非常值得。

PayPal API.

PayPal平台有一个扩展的api库，你可以使用它将PayPal功能集成到你的网站或应用程序中，而无需用户访问PayPal网站。

您可以使用的一些API包括Billing Plans API、Catalog Products API、dispute API和熟悉的发票、订单和支付API。

如果你正在建立一个电子商务网站，或为会员制组织创建一个网站，贝宝api将帮助你管理所有交易的每一步。你是否曾感到困惑，贝宝有一个强大的支援基地在这里，您可以访问经常被问到的问题，并获得其他从事PayPal集成项目的开发人员的帮助。

现在有大量的api可用。有些用于操作系统，有些用于网站，等等，但为了充分认识它们在数字经济中的潜力，让我们仔细看看api是如何根据它们与谁共享及其原因进行分类的。

这些名字很直观，所以我们将在下面简要地介绍每一种类型。

私人API.

私有api只对工作人员可用，以提高生产率和透明度。换句话说，为公司工作的开发人员可以根据需要使用这些api，但第三方开发人员不能。raybet电子竞技

事实上，由于这些API没有在公开发布的软件开发套件中记录（思考，用于在特定平台上创建软件应用程序的Starter套件）或在某些情况下，它们雷竞技苹果下载官方版通常完全隐藏在公众中。许多公司最终会与私人API一起公开。

合作伙伴API.

合作伙伴API是在外部共享的，但仅与与提供API的公司具有业务关系的人共享。raybet电子竞技合作伙伴API的逻辑，类似于公共API，植根于“如果你划伤我的背部，我会划伤你的想法。”

想想交通应用w例如，该公司使用api与市政当局和其他合作伙伴交换有关道路关闭、事故、施工延误、坑洼和工作车辆(如扫雪车和垃圾车)的数据。raybet平台

一些企业赞成在公共场所的合作伙伴API，因为他们希望更好地控制谁可以访问他们正在暴露的资源，并且在如何使用这些资源时更大的说法。reybet雷竞技下载例如，Pinterest采用了基于提交的方法通过API提供对新数据服务的访问，要求合作伙伴提交一个请求，详细说明他们希望如何使用API，以及在被授予访问权限之前，它将授予他raybet平台们哪些底层数据。

打开API.

开放api，也称为公共api，可供外部使用，因此，它们共享的资产往往比私有或合作伙伴api受到更多的限制。虽然一些开放式API是免费的另一些公司则需要缴纳订阅费才能使用，通常会根据使用情况进行分级。

公开api有无数的好处，但我们现在只关注两个主要的好处。通过共享api组织边界之外,公司吸取教训的支持,文档,和身份验证方案,提高其api和采用也鼓励第三方创建应用程序,附件,或集成api,不仅使他们的产品更有价值,也使api更有价值。

复合API

组合api允许您将调用或请求捆绑在一起，以获得来自不同服务器的统一响应。如果需要来自不同应用程序的数据，可以使用复合API。

或者，您可以使用这种类型的API来触发自动的调用和响应链，而不需要您的干预。

举个例子红绿灯．假设您想在购物车API中创建订单。您可能会认为这将采取一个请求，但实际上有几个需要做出的要求。首先，您需要创建客户配置文件。然后，您需要创建订单，添加一个项目，添加另一个项目，并更改订单的状态。连续使用复合API，您可以使用复合API进行五个单独的API调用。

为什么要使用API？

现在我们知道企业可以使用API安全地请求和共享内容，与内部和外部受众的服务和功能，您可能会思考为什么公司为什么可以支付另一个人可以自己创造的资源？reybet雷竞技下载raybet电子竞技为什么公司同意分享其资产，特别raybet电子竞技是竞争对手？或者为什么它会在制作API的所有工作中，所以它自己的劳动力可以使用它？

都是好问题。在深入了解答案之前，让我们将API的好处分为两类：API消费者和API提供者。

API消费者的利益

您可以使用api来请求访问另一个服务器的资源，或者您可以使用自己的api来自动化某些任务。reybet雷竞技下载不管怎样，您都要承担API使用者的责任。这些使用者可以以多种方式使用每种类型的API。

生产力

许多公司使用自己的API。为什么？在内部使用API使员工能够简化运营，促进协作，并增强整个公司的透明度。亚马逊创始人兼首席执行官杰夫·贝佐斯（Jeff Bezos）早在2002年就了解了内部API的巨大潜力，当时他发送了一封电子邮件，指示每个团队通过API进行沟通。按照“贝佐斯指令”，开发人员将其开发良好的软件组件构建或转化为API，从而在整个公司raybet电子竞技内建立一致且管理良好的数据和功能交换方式。雷竞技苹果下载官方版

用户满意度

公司希望为用户提供最佳体验。很少有一种产品能够满足并预测每一种需求和期望。这就是为什么他们使用API来扩展产品的功能。例如，OpenTable使用地图JavaScript API.在其网站上嵌入一个交互式地图，用户只需点击几下就可以知道从家到附近餐馆的方向。如果您不熟悉该网站，请查看此屏幕截图，其中显示了印第安纳州一家牛排馆的概况。

图片来源

创新

通过允许开发人员——无论是第三方还是您的工作人员的内部成员——重用软件组件，api使他们能够专注于开发新的解决方案，而不是重复已经完成的工作。雷竞技苹果下载官方版让我们回顾一下上面的例子。如果没有谷歌Maps API, OpenTable的开发人员将不得不投入他们的时间和资源来绘制他们自己的地图，并提供实时地图数据，以便在其站点上包含该功能。reybet雷竞技下载更糟糕的是，无论他们投入多少时间，都几乎不可能使它像谷歌现有的解决方案那样详细或可靠。因此，api使开发人员能够专注于创建新的工具和功能，为用户提供更多的价值，而不是浪费时间去重新发明轮子。

对API提供商的好处

既然您已经确信使用API的好处，那么让我们来关注一下为什么您可能希望创建一个API，然后与合作伙伴或公众共享。raybet平台

简言之，成为一个API提供商将打开商业机会和其他建立在简单使用API基础上的好处。让我们看看下面的每一个。

收入

容易答案是金钱。谷歌，喊叫，Facebook而成千上万的其他公司使他们的API公开并货币化他们，以便他们成为额外的收入线。事实上，在一些公司，API是收入的主要来源。据最近该报告由MuleSoft Inc.发布。在美国，35%的技术领袖通过api直接创造了他们组织四分之一以上的收入。

规模

通过与尽可能广泛的受众分享您真正擅长的内容，一个超越您的员工和客户(包括第三方开发人员和消费者)的用户网络将依赖于您的api提供的数据和功能。最终，这将提高主平台的使用和采用。换句话说，api不仅扩大了您的客户基础，它们还在数字经济中创造了新的市场机会。

亚马逊网络服务亚马逊(AWS)就是最著名的例子之一。这个平台基本上允许任何公司或开发人员通过api在亚马逊的技术基础设施平台上运行自己的应用raybet电子竞技程序，全世界有数百万客户在使用这个平台，这是值得信赖的将亚马逊从在线书店转换为全球数字巨头．

甚至更多的创新

是的，我又把它列出来了，但有点扭曲。在上面，我们讨论了API消费者如何从使用第三方解决方案中受益，第三方解决方案允许他们将时间和资源集中在改进自己的产品上，而不是重复工作。reybet雷竞技下载

然而，通常不会产生API消费者和提供者之间的关系更加促使。您可能会记住，在Twitter的早期，其用户界面有点笨重。然后Tweetdeck.Twitter是一个独立的应用程序，它在Twitter平台的基础上使用它的公共API构建了一个更好的用户界面，这样所有用户都可以有更好的Twitter体验。朋友们，这叫三赢。

如何使用API

所以你准备好尝试了你的API。怎么办？在为您的公司实施您自己的API之前，使用其他人的API是最有意义的。raybet电子竞技让我们通过API开始如何开始的基础知识。

1.选择一个API。

首先，您需要找到一个可以整合到业务中的API。你可能已经开始关注API了，特别是如果你对Facebook API这样的大假发感兴趣的话。您可能还希望按成本进行搜索-您可能希望从免费的API例如，在探索付费api之前。

一旦选择了API，就戴上老花镜。现在是时候浏览API文档了。

2.获取一个API密钥。

如前所述，API密钥用于将您标识为有效的客户端，设置访问权限，并记录您与API的交互。

有些Apis使他们的钥匙自由地提供，而其他API则要求客户支付一个。无论哪种方式，你都可能需要与服务注册。然后，您将分配给您的唯一标识符，您将包含在您的呼叫中。

始终将密钥设置为私钥，就像设置密码一样。如果您的密钥泄漏，一个坏角色可能会代表您发出API请求。如果出现这种情况，您可能会使旧密钥无效并获得新密钥。

3.审查API文件。

API文档本质上是关于如何有效地使用和集成API的指导手册。除了提供使用API所需的所有信息(比如是否需要API密钥)之外，它通常还包括示例和教程。

请参阅文档，了解如何获取密钥，如何发送请求以及您可以从其服务器获取的资源。reybet雷竞技下载

很难低估良好API文档的重要性 - 公司可能会提供强大的API，但如果开发人员无法快速学习如何使用它，那就不是很有价值raybet电子竞技

4.向端点写入请求。

接下来，您将编写第一个请求。最简单的方法是使用HTTP客户端帮助组织和发送你的请求。您仍然需要理解并从API文档中获取一些信息，但不需要太多编码知识就能成功。

在这个阶段，在线教程可以来救援。例如，这个YouTube视频解释了如何使用API​​从Google地图中提取位置数据，然后使用这些坐标在Instagram上查找附近的照片。

5.连接你的应用程序。

既然您已经了解了如何向选择的API发出请求，那么就可以使用它同步应用程序了。作为一个营销人员，你不需要担心这个阶段API集成．这是开发人员的工作，他们将使用一种或多种语言，如Python、Java、JavaScript(和NodeJS)、PHP等。

很有可能，您正在交互的API是一种特定类型的API，它被认为比其他API更容易使用。这些api称为REST api。

REST api

REST api遵循一种称为“具象状态传输”的软件架构风格的约束，这种风格使ap雷竞技苹果下载官方版i相对容易使用和发现。REST使数据和功能可以作为资源使用，这些资源由唯一的url表示。reybet雷竞技下载要通过REST API(如Open Weather Map API)请求资源，您只需要提供它的URL。

在典型的REST API中，资源将分配两个URL模式：复数（以指代所有资源）和单数（以指定单个资源）。reybet雷竞技下载这些也被称为端点。你能猜到为什么吗？因为他们走在URL的末尾。

每个端点还被分配了一个客户端可以向服务器请求的操作列表。因此，复数端点可以用于列出或创建资源，而单数端点可以用于检索、更新和取消特定资源。reybet雷竞技下载客户机必须在请求中包含正确的HTTP谓词(GET、POST、PUT、DELETE)，以告诉服务器要采取什么操作。

客户端和服务器可以使用三种数据格式来回传递此信息：

• 超文本标记语言(超文本标记语言)
• XML（可扩展标记语言）
• JSON（JavaScript对象表示法）

RESTAPI示例

WordPress有一个REST API这使开发人员能够通过在客户端和服务器之间携带JSON对象来远程创建，读取和更新WordPress内容。换句话说，通过允许开发人员轻松地构建他们想要将数据纳入服务器的方式，他们可以花费更少的时间访问所需的数据，更多的时间创造更好的用户体验。

休息vs. soap.

REST通常与简单对象访问协议(Simple Object Access Protocol, SOAP)针锋相对，SOAP是构建基于HTTP的应用程序的另一种方法。休息是被认为是更简单的选择肥皂，因为它需要较少的代码来完成任务，并且跟随比SOAP更少于刚性结构和逻辑。人们喜欢休息的另一个原因：它提供了大量的公约，但留下了设计API的人的决策。

下面是一个简单的测试，如果您正在为您的API选择REST和SOAP:如果您想要灵活性，那么使用REST。如果您想要标准化，请使用SOAP。

数字经济的未来

消费和提供API都有许多业务优势，但让我们保持简单。主要原因？将应用程序连接到软件世界的其余部分。雷竞技苹果下载官方版这些联系可以授权所有类型的组织，从初创企业到政府机构，以创造新的商业模式，在今天的数字经济中刺激更多的创新和想法。

通过这种方式，api不仅改变了公司的业务方式。它们正在改变企业思考业务的方式。

这篇文章最初发表于2019年10月，为全面起见已进行更新。