Api -- 连接世界的Super Star

文章目录

    • 🍏 一、api 的定义:数据共享模式定义 4 大种类
    • 🍖 二、api 使用场景:互联网时代,api 无处不在
      • 2.1 sql 查询
      • 2.2 数据传输
    • 🍤 三、开放 api(OpenAPI):开放双赢
    • 🍳 四、api 的痛点和 eolink 的解决方案
    • 🍕 五、小结

🍏 一、api 的定义:数据共享模式定义 4 大种类

作为互联网从业人员,api 这个词我耳朵都听起茧子了,那么 api 究竟是什么呢?

api 的定义,即应用程序接口(API:Application Program Interface)应用程序接口是一组定义、程序及协议的集合,通过 API 接口实现计算机软件之间的相互通信。

根据不同软件应用程序间的数据共享性能,可以将 API 分为四种类型:

  • 远程过程调用(RPC):通过作用在共享数据缓存器上的过程(或任务)实现程序间的通信。
  • 标准查询语言(SQL):是标准的访问数据的查询语言,通过数据库实现应用程序间的数据共享。
  • 文件传输:文件传输通过发送格式化文件实现应用程序间数据共享。
  • 信息交付:指松耦合或紧耦合应用程序间的小型格式化信息,通过程序间的直接通信实现数据共享。

🍖 二、api 使用场景:互联网时代,api 无处不在

在生活中,我们无时无刻都在使用 api,包含你打开的网页的同时,甚至触发了几百上千个 api,查询数据,系统之间交互,文件传输等等,api 都发挥了至关重要的作用。

2.1 sql 查询

小 A :我写了一个 SQL,查询到数据库里的数据。

# 从全世界找到你
select * from the_world where someone like 'you';
# 查询结果
A very big pig

2.2 数据传输

小 B :我打开一个 web 网页,页面的前端通过 https 接口获取到后端数据(拿到获取数据的 url 后,搞爬虫的小伙伴常用来下载数据)

🍤 三、开放 api(OpenAPI):开放双赢

一般来说,内部 api 是非常机密的信息。但有时候,网站的服务商需要将自己的网站服务封装成一系列 API(Application Programming Interface,应用编程接口)开放出去,供第三方开发者使用。

如图所示,开放 api 主要分为 5 大类:

  1. 电信类
  2. 地图类
  3. 电商类
  4. SNS 类
  5. 微博类

从而吸引一些第三方的开发人员在该平台上开发商业应用,平台提供商可以获得更多的流量与市场份额,第三方开发者不需要庞大的硬件与技术投资就可以轻松快捷的创业,从而达到双赢的目的。

开放 API 是大平台发展、共享的途径,让开发者开发一个有价值应用,付出的成本更少,成功的机会更多。

🍳 四、api 的痛点和 eolink 的解决方案

api固然很强大,但在使用过程中,也存在许许多多的难题。

要分析 api 的痛点,不得不提到使用 api 的各个项目角色,通过以下的工作流程图,可以看到不同项目角色是如何参与到与 API 相关的研发工作中的。

  • 后端工程师:约定接口、开发 api、编写文档、单元测试
  • 前端工程师:约定接口、页面开发、Mock api、前后联调
  • 技术管理者:技术评审、工期评估、管理文档
  • 测试工程师:自动化测试 api、缺陷分析、问题反馈、输出测试报告

api 无处不在,无处不用,如果没有有效的 api 管理协作模式,不仅影响项目进度,大大增加开发成本,甚至出现被逼离职的尴尬境地!!!

在此,我总结了工作使用 api 的 5 个主要痛点,以及 eolink 的针对性解决办法!!!

序号api 使用痛点Eolink 的解决方案适用岗位
1不愿意编写文档,但又不得不写。 写接口文档是很枯燥乏味的工作。写好一个接口文档需要填写各个琐碎的字段。所以大家都更加愿意把时间花在编码上,仅草草的应付接口文档的编写工作。根据代码生成文档 。Eolink 提供 IDEA 插件,可以基于代码一键生成 API 文档并同步到 Eolink 对应的项目中。接口文章除了提供展示标准的基础信息、请求参数、响应参数等字段后。还可以增加例如字段额外说明,标签,接口状态等信息。后端工程师
2接口文档的理解成本普遍比较高 前端工程师需要阅读接口文档来理解这个接口的出入参条件和业务能力。但接口文档往往要不描述信息简单,甚至有缺写漏写条件的情况,让人难以完全理解其接口。要不就是文档的模块信息混乱,无法快速理解接口内容。简约但不简单的接口文档展示。 Eolink 的接口文档展示和主流的文档展示层次一致。分基础信息,请求数据,返回数据,返回示例等。不一样的是,对每个模块做了简约的补充描述设计。前端工程师
3Mock API 编写麻烦 API 文档数据需要从 swagger 导入到对应的工具中,例如每个接口所有字段都要编写 Mock 规则等,整个流程还是比较麻烦。智能 Mock。Eolink 提供市面最强的 Mock 体系,主要体现在可按不同的条件设置不同的 Mock 结果,以及提供智能的 Mock 配置方式。甚至系统可根据 API 文档自动生成标准的 Mock 规则,前端工程师无需编写,立即使用。前端工程师、测试工程师
4变更无通知同步 。因为前后端分离的开发很依赖文档的准确性和稳定性,若果后端工程师对接口进行了变更,但是在文档上无体现或者不通知前端工程师。会导致前端工程师沿着以前旧版本接口文档的内容进行 Mock 设计和前端页面开发。最终前后联调时才发现对不上,需要重新更改代码,造成了大量的返工。变更实时通知和快速同步。Eolink 能提供接口文档变更快速通知的能力,无论是站内消息,还是第三方通讯工具,均能通过简单的配置搭建好通知渠道。前端工程师无需额外的配置调整操作,降低维护压力。后端、前端、测试
5API 资产分散难以沉淀。 API 接口是业务代码标准化的价值实现载体,是重要的研发资产。但 API 接口文档往往分布散落在各个服务器上部署的 swagger,或者各个独立的在线研发文档中。难以以一个公司,或者一个部门的维度来对 API 文档进行统一归档管理。多层级 API 管控 。 Eolink 的核心功能就是 API 接口文档仓库,提供对全公司的 API 文档进行多层级组织权限管控。可以解决 API 文档资产沉淀难的问题。技术管理者

🍕 五、小结

互联网时代,api 无处不在,无处不用。

如何管理和使用 api,也成了研发、测试和项目管理者小白变大佬的必修课,今天的 api 科普和管理方法就到这里,see you!

体验地址:https://www.eolink.com/?utm_source=qyzzh&utm_medium=csdn&utm_content=zhpy01

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/494246.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

2018全球最强物联网公司揭晓!

来源:数字化企业根据Gartner预测, 到2020年将有超过200亿台联网设备,市场价值将达3000亿美元之巨。随着垂直应用上的不断细分,以及与AI的加速整合,物联网不仅将持续地变革人们的生活和工作,市场规模也将持续…

Android之解析GML并显示

本例主要实现在APP中解析GML数据并显示 GML,地理标记语言(外语全称:Geography MarkupLanguage、外语缩写:GML),它由开放式地理信息系统协会(外语缩写:OGC)于1999年提出,…

中国电子学会发布《新一代人工智能领域十大最具成长性技术展望(2018-2019年)》...

来源:中国电子学会当前,全球正在经历科技和产业高度耦合、深度迭加的新一轮变革,大数据的形成、理论算法的革新、计算能力的提升及网络设施的演进驱动人工智能进入新一轮创新发展高峰期,新技术持续获得突破性进展,呈现…

晓得不,中间表是这样被消灭的

目录 一、中间表的产生 1、一步算不出来 2、实时计算等待时间过长 3、多样性数据源参加计算 4、中间表难以删除 二、文件计算 三、高性能文件格式 四、易管理性 五、多数据源支持 六、集成性 七、资料 一、中间表的产生 中间表是数据库中专门存放中间计算结果的数据…

美国五大科技巨头的人工智能竞赛

来源:资本实验室毫无疑问,人工智能已经开始渗透到各行各业,并正在改变我们的工作方式和生活方式。2017年,全球与人工智能相关的资金投入总额达到152亿美元,比上一年增加144%。而无论在投资,还是…

模拟Struts2实现

本文主要是一个模拟的Struts2的简单实现 真正的MVC架构 实现主要思路 定义一个过滤器&#xff0c;接收传递过去的Action&#xff0c;根据处理的结果重定向或者转发。 首先定义index.jsp <% page language"java" import"java.util.*" pageEncoding&q…

实战教学--怎样提高报表呈现的性能?

报表的性能很重要&#xff0c;是一个总被谈及的问题&#xff0c;跑的慢的报表用户体验恶劣&#xff0c;无法忍受。解决这些慢的性能问题&#xff0c;也成了项目方和工程师头疼的事情。一出状况&#xff0c;就得安排技术好的&#xff0c;能力强的工程师去救火&#xff0c;本来利…

WiFi共享精灵 - 不需路由器一键轻松把网线共享给手机、笔记本等同时无线上网...

现在人们身边手机、游戏机等各种使用WiFi上网的设备已经越来越多&#xff0c;但经常遇到一些地方只有有线网络&#xff0c;或者没有无线路由器的情况&#xff0c;这时&#xff0c;用笔记本上网&#xff0c;然后把网络通过WiFi共享给其他设备上网那么就最合适了。我们之前有介绍…

干货|李开复最新刷屏演讲:人工智能最难取代这13种工作,也最容易威胁人性与爱!...

来源&#xff1a;澎湃新闻这两年&#xff0c;创新工场董事长兼首席执行官李开复&#xff0c;一直为人工智能站台和奔走&#xff0c;还出新书帮助人们规划未来的AI生活。他预言&#xff0c;中国有望在全球范围内首先实现OMO&#xff08;Online-Merge-Offline&#xff0c;线上线下…

Apifox vs Eolink,国内 Api 工具哪家强?

目前行业内有 postman、jmeter 为代表开源 Api 工具派系&#xff0c;我想对大家对这两个词并不陌生。虽然它们能解决基本的接口测试&#xff0c;但是无法解决接口链路上的所有问题&#xff0c;一个工具难以支持整个过程。 在国内&#xff0c;我们可以看到有国产 API 管理工具&…

人工智能、区块链、混合现实:2019年新闻、媒体与技术趋势

来源&#xff1a;资本实验室近日&#xff0c;未来今日研究所&#xff08;Future Today Institute&#xff09;发布了《2019年新闻、媒体与技术趋势报告》&#xff0c;报告提出了涵盖多个领域的108个新兴技术趋势。报告显示&#xff0c;未来的新闻、媒体等行业将受到各种技术错综…

活久见:都 2203 年了,你还在使用 word 调试 API

随着信息技术的发展&#xff0c;API 变得无处不在&#xff0c;无处不用。但令人费解的是&#xff0c;都 2203 年了&#xff0c;竟然还有很多人使用 word 调试 API&#xff1f; 今天&#xff0c;西红柿将带领大家打开新世界的大门&#xff0c;放下诺基亚&#xff0c;抄起智能机&…

Struts2基础知识

本文主要包括以下内容 struts2常用常量的定义与意义struts2处理流程拆分struts动态方法调用,使用通配符接收请求参数中文编码问题自定义类型转化器访问或添加request/session/application常用servlet对象的获取 struts2常用常量的定义与意义 struts2处理流程 每一次请求都会创…

自动驾驶汽车测试在美惹争议,原因为何?

来源&#xff1a;中国汽车报摘要&#xff1a;近日&#xff0c;针对美国总统特朗普提出的&#xff0c;汽车制造商需自愿提交他们在公共道路上测试自动驾驶汽车安全报告一事&#xff0c;回应者寥寥&#xff0c;目前只有三家汽车公司响应了上述要求&#xff0c;提交了相关材料。据…

Struts2基础知识(二)

本文主要包括以下内容 文件上传&#xff0c;多文件上传 自定义拦截器 用户输入验证国际化 文件上传 将头设置为enctype”multipart/form-data” <body><form action"${pageContext.request.contextPath}/upload/upload1.action" method"post" …

想做自动驾驶技术的入,这回分享一个简单好用的开放平台

前言 自动驾驶已经是现在技术开发领域最热门的方向之一&#xff0c;作为程序员&#xff0c;很多人也都想来这个领域试试水。但是这个领域的门槛也挺高&#xff0c;不过想开始的话&#xff0c;其实可以从一些专门针对自动驾驶的开放平台开始入手&#xff0c;目前比较主流的可以…

潘建伟团队再登Nature:全球首次实现器件无关量子随机数,量子保密通信安全再升级...

岳排槐 编辑量子位 出品 | 公众号 QbitAI据消息&#xff0c;潘建伟团队日前成功实现了器件无关的量子随机数&#xff0c;将在数值模拟、密码学等领域广泛应用&#xff0c;并有望形成新的随机数国际标准。相关研究成果于北京时间20日由国际权威学术期刊《自然》在线发表&#xf…

一篇文章搞懂数据仓库:数据治理(目的、方法、流程)

目录 1、什么是数据治理 2、数据治理的目的 3、数据治理的方法 4、数据质量8个衡量标准 5、数据治理流程 1、什么是数据治理 数据治理&#xff08;Data Governance&#xff09;是组织中涉及数据使用的一整套管理行为。由企业数据治理部门发起并推行&#xff0c;关于如何制…

在OEL5上安装配置Oracle Gird Control 10.2.0.5

早期的Grid Control问题实在太多了&#xff0c;以至于把10.2.0.1的Grid Control升级到10.2.0.5几乎是不可能完成的任务&#xff1b;此外10.2.0.5以前的gc不支持11g作为repository database仓库数据库&#xff0c;不仅于此10.2.0.1版本是不支持rhel5或OEL5的&#xff0c;如果想安…

Struts2基础知识(三)

本文主要包括以下内容 OGNL表达式标签 防止表单重复提交 使用第三方插件tomcat启动时struts2容器做的事 OGNL表达式 OGNL是Object Graphic Navigation Language(对象图导航语言)的缩写&#xff0c;它是一个开源项目。Struts2框架使用OGNL作为默认的表达式语言。 相对EL表达…