文章采集api(API接口是什么?为什么我们需要实际上接口?(图))

优采云 发布时间: 2022-03-05 14:05

  文章采集api(API接口是什么?为什么我们需要实际上接口?(图))

  对于很多产品新手或者求职者来说,API接口是产品和研发领域的一个专业名词,大家可能在文章或者PRD都接触过API接口的概念。

  事实上,接口的应用已经非常广泛和成熟。这个概念主要活跃在公司内部各个系统之间的连接对接以及公司之间的合作场景中。如果你能仔细阅读这篇文章,相信你对API接口的理解会更深,甚至超过90%的新手和求职者。

  

  本文目录:

  API接口是什么?为什么我们需要API接口?API接口的核心一、什么是API接口?

  让我们用一个常见的数学公式来理解API,比如y=x+2,当x=2时,y=4,对吧?

  这时候我们调用y=x+2接口,x=2参数,y=4返回结果,那么这个接口的作用就是把我们输入的数字加2(注意:这里你可以发现接口本身有逻辑)。

  

  以此类推,让我们理解一个常见的场景。比如有一个接口可以把经纬度转换成城市。当我输入55°的经纬度和88°的纬度时,界面会使用自己的逻辑运算,返回结果告诉我:杭州市。

  这样就可以清楚的看懂百度百科的官方解释了。接口是预定义的功能逻辑。其他系统请求然后返回结果是一回事。

  二、为什么我们需要一个 API 接口?

  背景:我们的业务系统涉及到很多方面。如果我们想要一个公司或一个系统来完成所有的业务,那就太费力了,对吧?而如果其他系统或公司有更好的操作逻辑,我们在设计功能时可以考虑使用接口进行开发。

  核心需求:利用现有接口可以降低开发成本,缩短开发成本。

  例如:比如我是一个打车app,现在我需要在我的页面上显示地图功能。对于我们公司来说,新的地图功能太贵了。然后我们可以使用高德开放平台或者百度地图。打开平台,找到地图API,在这种情况下,我们只需要购买高德的服务,部署并调用高德地图API,就可以在我们的页面上快速启动地图功能。

  

  三、API接口的核心

  对于小白来说,第一次看 API 文档可能会让人迷惑——在哪里看,怎么看,摆在你面前的问题是什么。

  其实对于产品经理来说,我们更应该关注的是这家公司能提供什么样的API接口服务。比如我知道高德可以提供地图API和规划路线的API。这样,我们就可以想到调用我们的设计函数和工作。他们的服务或参考。

  因此,产品新手如果不了解,也无需过于担心。以后你也会对它有更深的理解,因为它理解起来并不复杂。以下是API接口的核心要点。所有的文档都离不开这五个核心。观点。

  以下以微信开放平台为例进行说明。文末有各个开放平台的地址。有空的时候可以学习。好了,废话不多说,我们现在来搭建一个场景。

  我们现在有一个APP,需要用户在购买时调用微信支付接口才能完成购买。请自动进入这个场景,把自己想象成一个产品经理。

  1. 接口地址

  现在,用户点击支付,我们需要告诉微信我们要打电话给你的收银员!但是在哪里说呢?这就需要接口地址,相当于把指定的数据传给微信链接。

  链接地址不是我们所理解的页面。您可以将其理解为电话号码。新手应该改变这个概念。

  至此,我们可以看到接口文档告诉我们链接如下,所以我们现在已经拨通了微信的号码。

  2. 请求参数(消息)

  我们现在需要告诉微信你要打电话给收银员,对吧?然后我们需要把它写下来。此时生成的消息称为消息,即你要告诉的界面内容是什么?相当于前面函数的输入 x=2。

  一般来说,消息的格式和内容是根据接口文档指定的。以下是微信开放平台呼叫收银的消息要求。

  

  我们先来看前两个参数。你现在正在和微信聊天。要不要先告诉微信,你是谁?这里的微信文档告诉你应该使用app ID+商户号来确定你的身份。那是什么意思?

  比如你是商户,下面有a、b、c三个APP,那么微信需要知道你是哪个商户,下面哪个APP使用收银台。这个非常重要。微信应将收到的款项转到相应的账户和统计数据。

  然后我们在消息中写下这两句话:

  好吧,现在微信知道你是谁了,所以你得告诉微信你需要微信支付多少钱才能向你收费,对吧?这里定义了币种和总额,即收取什么币种,收取多少。

  

  这里你看,币种一定要填,也就是说你也不能告诉微信支付是什么币种,因为他说默认是*敏*感*词*。

  好吧,让我们写两段

  

  好了,现在微信知道你是谁,你要收多少钱,那么微信支付就会告诉你支付的结果,因为你要知道用户已经支付成功,才能继续发货、服务等。所以这里我们使用通知地址,就是告诉微信,等事情结束他会去哪里告诉你支付结果。然后我们写地址:

  3. 返回结果

  微信支付刚去收钱,现在他想在我们留下的通知地址告诉我们结果。结果不外乎两个:采集成功?收款失败?

  (1)成功

  很顺利,现在用户支付成功了,微信也把成功的消息告诉了我们,他也告诉了我们用户支付的一些信息。

  那么这里就是收款成功后微信支付告诉我们的信息。

  

  应用APPID,商户ID:告诉你我成功扣款的是哪个商户的APPID交易。

  业务成果:成功或失败

  (2)失败

  在设计产品时,我们常常非常关心失败。当采集失败时,微信也会告诉你失败的原因。下面这张图很容易理解。失败的原因有很多。在设计的时候,我们经常去分析每一个失败的原因,设计每一个失败原因的页面和用户提示,以保证用户理解。

  

  以上就是对API接口基本操作方式的理解。接下来我会继续更新API接口的一些更深入细致的关键元素,比如请求方法/签名/加解密等。

  一个开放的平台供参考网站

  微信支付:

  高德平台开放平台:

  本文由@islovesleeping原创 发表于每个人都是产品经理。未经许可禁止复制

  题图来自Unsplash,基于CC0协议

0 个评论

要回复文章请先登录注册


官方客服QQ群

微信人工客服

QQ人工客服


线