2021 年 4月随笔档案 - 隔壁王书

微服务与API

摘要：软件体系结构是用于软件系统开发和实施的高级结构。随着软件变得越来越普及，不同的体系结构风格随之发展。在这种形势下，微服务架构获得了很大的吸引力和相关性。什么是微服务？微服务（也称为微服务体系结构）是一种架构样式，将应用程序构造为一组松散耦合的服务，每种服务均实现业务功能。微服务架构可实现大型复杂阅读全文

posted @ 2021-04-30 12:14 隔壁王书阅读(300) 评论(0) 推荐(0) 编辑

【分享】有关SDK和API的思考

摘要：以前只知道不管是API还是SDK，直接调用就行了，但是现在定制化要求越来越高，API和SDK的区别也越来越大。不过可能有人不知道SDK和API的区别，先简单科普一下。 SDK和API都是类似于公共服务的东西，都代表的是一种封装，只是封装的形式不一样。具体的理论不细说，直接来举个例子：支付宝是我阅读全文

posted @ 2021-04-29 16:45 隔壁王书阅读(184) 评论(0) 推荐(0) 编辑

API设计和微服务

摘要：API设计意味着提供有效的接口来帮助API的使用者（内部和外部）更好地了解、使用和集成API，同时帮助自身有效地维护它。如今，API是服务之间通信的标准形式，但是，随着越来越多的服务出现，维护API的复杂性也随之增加。大多数团队仍然遵循“代码优先”的API开发方法关于设计优先方法开发API或构建阅读全文

posted @ 2021-04-29 15:42 隔壁王书阅读(164) 评论(0) 推荐(0) 编辑

Eolinker与API文档

摘要：API描述格式，以及像Eolinker这样的API管理工具的实现，改变了API团队对API文档的思考方式。通过提供一种格式来定义API的操作，这种格式是人机可读的，将这些操作可视化，让用户与API进行交互，这些工具摆脱了手动维护API文档的麻烦。带给API团队的好处。维护API文档一直是一个痛苦阅读全文

posted @ 2021-04-29 14:41 隔壁王书阅读(222) 评论(0) 推荐(0) 编辑

API设计流程

摘要：良好的API设计被认为是API团队的“必备条件”。在当今的API经济中，API是业务战略的驱动力，API可用性正在增强从单片到微服务体系结构的过渡能力，优良的设计从未如此重要。了解API设计 API设计意味着需要提供一个有效的接口，帮助API使用者（内部和外部）更好地了解、使用和集成，同时帮助自身阅读全文

posted @ 2021-04-28 17:15 隔壁王书阅读(323) 评论(0) 推荐(0) 编辑

【实例】如何分享和生成html格式的接口文档

摘要：这期抽出来的问题是关于接口文档生成、分享和导出html格式，下面是使用Eolinker演示的实例。自动生成和在线分享接口文档接口开发完测试好之后就需要编写接口文档，eolinker自带接口文档生成功能。如下图确认接口数据可用后，我们只需要保存好接口的数据，然后点击分享，就可以分享api给同事了阅读全文

posted @ 2021-04-27 17:20 隔壁王书阅读(477) 评论(0) 推荐(0) 编辑

【分享】项目开发容易出现的问题？身为前端/后端你见到过吗？

摘要：导读前端后端分模式下接口的作用和意义，已经有很多文章说过了，随手搜一下就行。这里想说的是由此引申出的另外几个问题： 1、接口数据的纷乱芜杂； 2、工作流程的杂乱无章； 3、数据格式的各行其是。场景一 “这个数据不对啊？”项目经理又开始抱怨了。找到了前端同学，前端同学排查了半天找不到原因，只好去问阅读全文

posted @ 2021-04-27 15:36 隔壁王书阅读(143) 评论(0) 推荐(0) 编辑

标准化API设计的重要性

摘要：API设计领域的一致性是一个广泛讨论的话题。标准化的API设计是团队在制作易于维护、采用和使用API的过程中需要考虑的下一个重要因素。也就是说，团队没有花太多时间来标准化API的设计方式，部分原因是他们没有意识到这样做的价值。什么是API设计中的标准化？ API设计是创建一个有效的接口，使得更好地阅读全文

posted @ 2021-04-27 10:17 隔壁王书阅读(414) 评论(0) 推荐(0) 编辑

【分享】对外API接口安全设计

摘要：前言最近公司业务需要对外提供接口，之前没有什么对外接口开发经验所以最近找了很多文章，恶补了一下对外接口开发知识，这篇算是自己开发接口的一个总结吧。下图我设计接口的大体流程对外接口的安全问题 1.传输过程的安全请求报文在网络传输过程中可能会被劫持篡改请求参数信息，导致服务端接收错误的参数。所以我阅读全文

posted @ 2021-04-26 17:34 隔壁王书阅读(431) 评论(0) 推荐(0) 编辑

【实例】调用数据库自动生成接口代码

摘要：这期抽出来的问题是通过调用数据库自动生成接口代码的，下面是使用Eolinker演示的实例。首先我们要新建一个项目，API Factory 中所有的 API 都以项目的方式进行归类管理，一个项目对应一种数据源类型。 API Factory 中，一个 API 对应一个数据源中的一个数据表的一种操作，比阅读全文

posted @ 2021-04-26 15:42 隔壁王书阅读(667) 评论(0) 推荐(0) 编辑

【翻译】API-First是什么概念？有什么商业价值？

摘要：从2015 年起，“API”一词逐渐破圈，也宣告了“API 经济”的到来。现在“API-First”被很多人挂在嘴边，但其实大部分人并不完全清楚它的含义。本质上，API-First 体系架构是一种软件设计的方法。它以 API 为中心，创建可以轻松互连的应用程序。API-First 开发出来的应用程阅读全文

posted @ 2021-04-26 14:17 隔壁王书阅读(971) 评论(0) 推荐(0) 编辑

保障接口安全的5种常见方式

摘要：一般有五种方式： 1、Token授权认证，防止未授权用户获取数据； 2、时间戳超时机制； 3、URL签名，防止请求参数被篡改； 4、防重放，防止接口被第二次请求，防采集； 5、采用HTTPS通信协议，防止数据明文传输；所有的安全措施都用上的话有时候难免太过复杂，在实际项目中需要根据自身情况作出取舍阅读全文

posted @ 2021-04-23 17:05 隔壁王书阅读(1493) 评论(0) 推荐(0) 编辑

【翻译】使用OpenAPI规范进行安全的API设计

摘要：API安全性是网络安全的重中之重。诸如云原生应用程序，无服务器，微服务，单页面应用程序以及移动和物联网设备等新兴趋势和技术已导致API的激增。应用程序组件不再是在单个进程中在一台机器上彼此通信的内部对象，而是通过网络相互通信的API。这显着增加了攻击面。此外，通过发现和攻击后端API，攻击者通常可阅读全文

posted @ 2021-04-23 15:54 隔壁王书阅读(618) 评论(0) 推荐(0) 编辑

为什么需要API文档

摘要：API是平台经济的推动者，允许用户在现有产品的基础上增强和添加服务。想了解如何有效地使用API，则需要依靠 API文档。本文将探讨编写API文档意味着什么，以及为什么编写好API文档很重要。什么是API文档？ API文档是可交付的技术内容，其中包含有关如何有效使用API以及如何与API集成的说明。阅读全文

posted @ 2021-04-23 14:33 隔壁王书阅读(260) 评论(0) 推荐(0) 编辑

【学习】什么是接口文档，如何写接口，有什么规范？

摘要：一、什么是接口文档？在项目开发中，web项目的前后端分离开发，APP开发，需要由前后端工程师共同定义接口，编写接口文档，之后大家都根据这个接口文档进行开发，到项目结束前都要一直维护。二、为什么要写接口文档？ 1、项目开发过程中前后端工程师有一个统一的文件进行沟通交流开发 2、项目维护中或者项目人阅读全文

posted @ 2021-04-21 18:02 隔壁王书阅读(833) 评论(0) 推荐(0) 编辑

【分享】接口自动化测试当道？工具/框架如何选择？

摘要：当今，“自动化测试”大行其道，其中“接口自动化测试”便是同行们谈得最多的话题之一。了解测试金字塔分层理念的童鞋都清楚，接口自动化测试有以下优点：投入低，产出高。比UI自动化更稳定。比单元测试更接近真实业务。正因为以上优点，接口自动化测试逐渐成为了业界主流，各种工具/框架层出不穷，比如 Eol 阅读全文

posted @ 2021-04-21 15:04 隔壁王书阅读(192) 评论(0) 推荐(0) 编辑

【实例】如何发送各类型API请求和更换body请求参数类型？

摘要：这期抽出来的问题是关于发送get、post等请求，以及更换body请求参数类型，下面是使用Eolinker演示的实例。发送get、post请求新建一个接口选择请求方法为get，输入url：www.baidu.com,点击发送，一个简单的get接口请求就完成了。 post请求则是直接选择请求方法为阅读全文

posted @ 2021-04-20 18:00 隔壁王书阅读(996) 评论(0) 推荐(0) 编辑

【API新闻】Facebook5.3亿用户数据库泄露？如何保证API安全？

摘要：数据泄漏：Facebook 最近最大的数据泄漏新闻是拥有5.3亿Facebook用户的庞大数据库。Facebook已就此事件发表了正式声明，对此表示轻描淡写，因为早在2019年就已经使用Facebook的API“抓取”了数据，而不是通过某种数据库访问或其他“直接”攻击获得的数据。攻击者利用的漏洞位阅读全文

posted @ 2021-04-20 16:03 隔壁王书阅读(284) 评论(0) 推荐(0) 编辑

API文档是开发人员的秘诀

摘要：在提供出色的开发人员体验方面，没有什么可以替代高性能，易于使用的API。开发人员的经验是从提供团队希望使用的可靠API开始，并且可以信任它们来安全集成到系统。提供出色的开发人员体验的一个关键组件是提供准确和最新的API文档。API文档是成功使用API并与之集成所需的信息。可以采用技术编写，代码示例阅读全文

posted @ 2021-04-19 17:22 隔壁王书阅读(75) 评论(0) 推荐(0) 编辑

【学习】关于接口自动化和UI自动化的策略

摘要：如上图所示，UI测试、接口测试和单元测试是都是测试环节需要走通的，其中单元测试通常是由开发同学完成，这里就不展开了，重点说一下我理解的UI自动化和接口自动化策略。 UI测试 UI测试是最接近软件真实用户使用行为的测试类型。通常是模拟真实用户使用软件的行为，即模拟用户在软件界面上的各种操作，并验证这些阅读全文

posted @ 2021-04-15 18:12 隔壁王书阅读(570) 评论(0) 推荐(0) 编辑

【翻译】API开发如何提高效率：设计优先还是代码优先？

摘要：随着api设计规范的普及，我特地花时间整理了基于历史使用和最佳实践构建API的最佳方法。API描述格式可以作为用户可用的规范，来帮助理解如何最好地使用API。这个规范与计算机语言无关，人和计算机都可以阅读，可以帮助简化应用程序的抓取，和提高程序之间的可操作性。设计优先与代码优先API开发在使用A 阅读全文

posted @ 2021-04-15 09:46 隔壁王书阅读(112) 评论(0) 推荐(0) 编辑

用于实现更快API设计的API管理平台

摘要：Eolinker一直致力于为设计、记录和构建API，提供最快、最易于使用的平台。Eolinker平台的中心是一个功能强大的基于云的编辑器，可使用适当的反馈和帮助来设计和记录API。自启动Eolinker以来，我们收集了很多关于用户最需要的编辑器的反馈，以及如何更好地提高编辑器的功能来满足用户的需求。阅读全文

posted @ 2021-04-13 18:03 隔壁王书阅读(141) 评论(0) 推荐(0) 编辑

什么是API生命周期管理

摘要：应用程序编程接口（API）已经成为业务增长和技术敏捷性的重要工具。API使两种不同的服务能够交互并相互补充，从而为一系列工程和业务可能性打开了大门。因此，开发强大而具体的API来促进API经济发展是一个的重要考虑因素。但是，开发API程序本身并不是一件容易的事。从概念到弃用API涵盖了整个API生命阅读全文

posted @ 2021-04-13 16:49 隔壁王书阅读(759) 评论(1) 推荐(0) 编辑

确保良好API设计的方法

摘要：设计一个API协议绝非易事。从API的初始计划（包括战略和功能目标）开始，生成API协议是优先事项。将该计划转换为实际的人机可读API协议需要花费大量时间和精力，尤其是考虑到这将影响API的未来开发和使用。良好的开发人员体验（DX）已经开始成为用户选择和采用API的一个重要区别因素，而良好的DX从设阅读全文

posted @ 2021-04-13 14:35 隔壁王书阅读(72) 评论(0) 推荐(0) 编辑

Eolinker引入Swagger集成

摘要：API是将高度互联的数字经济连接在一起的粘合剂。在这样的环境中，能够安全地管理和监视API，确保API的稳定性和性能是非常重要的。这就是API管理解决方案的用武之地。认识到开发人员需要将API定义和文档轻松部署到API管理解决方案中，Eolinker开发了可直接与Swagger上的API连接同步功能阅读全文

posted @ 2021-04-12 17:50 隔壁王书阅读(248) 评论(0) 推荐(0) 编辑

使用Eolinker可以帮助记录API

摘要：开发人员体验是常规用户体验的扩展，它强调了开发人员在使用API方面的体验。良好的API开发人员经验不仅仅局限于技术范围，还需提供所有正确的资源，帮助最终消费者成功地集成和使用您的API。文档的作用精心设计的开发人员体验以API文档为中心。 API文档是成功使用和集成API所需的信息。这将采用技术阅读全文

posted @ 2021-04-12 16:11 隔壁王书阅读(92) 评论(0) 推荐(0) 编辑

如何优化API工作流程

摘要：API是业务和战略计划的驱动力，并且许多团队现在已经开始在API战略上进行大量投资。在开发API策略上进行大量投资的团队超出了传统技术的领导者范围。从金融服务到医疗保健、教育再到制造业等行业，API的采用率都有了显著的增长。伴随着API的激增，许多API工具也应运而生，比如Eolinker，它有阅读全文

posted @ 2021-04-12 14:59 隔壁王书阅读(76) 评论(0) 推荐(0) 编辑

弃用API需要了解什么

摘要：API领域中经常出现的一个话题是公司决定弃用API的版本，或者完全关闭对API的支持。作为向公众提供API的团队，重要的是要制定一个计划，以计划如何管理不同版本的API的弃用和报废。那么团队如何最好地弃用API？首先，让我们了解API弃用的原因，然后重点介绍一些建议的做法以有效弃用。何时不推荐使阅读全文

posted @ 2021-04-09 18:15 隔壁王书阅读(271) 评论(0) 推荐(0) 编辑

【工具】可以在线使用查看的企业级接口文档工具

摘要：Eolinker是国内使用人数较多的国产企业级接口管理和接口文档工具，通过即时精准的通知和完善的版本对比功能，提高各种规模团队的协作效率。特性：支持手动创建 API 文档；可自动从代码中识别注解生成 API 文档；支持多种格式接口文档的导入和导出；兼容市面上绝大部分API工具；支持一键切阅读全文

posted @ 2021-04-09 17:00 隔壁王书阅读(121) 评论(0) 推荐(0) 编辑

【分享】微软也有API漏洞？API网关是正解吗？

摘要：漏洞：Microsoft联机帐户重置账户密码的API节点是常见的攻击矢量，攻击者通过提交海量的重置密码的代码组合，在有限的时间窗口内强制执行重置密码的操作。最近微软就被发现了这么一个API漏洞，攻击者可以通过上述的方式来强行破解并重置微软用户的密码。后续微软已经解决了这个问题，并给了这位黑客5 阅读全文

posted @ 2021-04-08 17:02 隔壁王书阅读(143) 评论(0) 推荐(0) 编辑

【实例】如何模拟后端接口返回数据？

摘要：这期抽出来的问题是关于模拟后端接口提前返回数据，也就是我们经常说到的Mock开发。前言 Mock近几年也有很多成熟的框架，包括Vue等等都有Mock服务，但是如果你对框架不熟悉，或者不想去学，也有很多工具可以做到可以让你简单地使用Mock来模拟后端接口。接下来我会介绍如何使用Eolinker进行阅读全文

posted @ 2021-04-08 15:55 隔壁王书阅读(912) 评论(1) 推荐(0) 编辑

构建API的方法

摘要：在当今超连接的世界中，API日益普及，遍及软件领域，允许进行新的和经过改进的创新来推动战略和业务计划。近年来，一种构建和使用RESTful API的新技术在业界迅速获得了广泛的关注，如何制定API开发策略，以及大型项目进行版本控制成为优先处理的问题。什么是RESTful API？ RESTful 阅读全文

posted @ 2021-04-08 14:08 隔壁王书阅读(269) 评论(0) 推荐(0) 编辑

【分享】工作中的前后端合作方式？如何减少接口变更？

摘要：引言看了很多论坛包括 V2EX 、知乎的讨论，发现前后端主流做的合作方法都是： 1、前后端先商定一份接口文档（如果自动化一点，那么可以写一堆未实现的方法，然后用 swagger 生成文档） 2、接着，前后端并行地开发，后端实现接口，前端依据接口文档进行开发 3、前后端联调问题但是，在实际操作的阅读全文

posted @ 2021-04-08 12:08 隔壁王书阅读(213) 评论(0) 推荐(0) 编辑

通过Eolinker中的对比改善API文档工作流程

摘要：使用Eolinker记录RESTful API，以人类和机器可读的格式清楚地详细说明API的所有资源和操作，为最终用户提供更简易的开发，更好的发现和更好的集成体验。让合适的人员参与API文档在API生命周期的设计和文档编制阶段，不仅仅只有开发人员和API设计师参与。如果团队认真考虑编写API文档阅读全文

posted @ 2021-04-08 10:39 隔壁王书阅读(127) 评论(0) 推荐(0) 编辑

使用Eolinker和GitLab无缝管理API文档

摘要：Eolinker支持多个平台的集成。集成有助于开发人员方便、快速的让多个平台的API文档保持同步和更新。 Eolinker 尽管源代码管理工具非常适合托管代码，但它们不适合编辑、设计和构建API。源代码管理主机并不适用于RESTful接口，借助Eolinker，用户现在可以无缝集成GitLab中的阅读全文

posted @ 2021-04-07 17:55 隔壁王书阅读(399) 评论(0) 推荐(0) 编辑

保持API文档为GitHub库最新版本

摘要：Eolinker是一个方便集成的平台，用于构建，记录和部署API。Eolinker引入了与GitHub的集成，使团队可以无缝地将生成的API定义和代码推送到源代码管理存储库中。为了满足满足团队在API生命周期内工作，Eolinker正在不断增加新的集成工具。通过简单的方式管理API Eolink 阅读全文

posted @ 2021-04-07 16:38 隔壁王书阅读(97) 评论(0) 推荐(0) 编辑

【翻译】API设计最佳实践

摘要：好的API设计对于那些试图完善API策略的团队来说是一个很重要的话题。一个设计良好的API的好处包括：改进的开发人员体验、更快的文档编制和更高的API采用率。但是，好的API设计到底需要做什么呢？在本文中，我将详细介绍一些设计RESTful API的最佳实践。设计良好的API的特性通常，有效的阅读全文

posted @ 2021-04-07 14:54 隔壁王书阅读(106) 评论(0) 推荐(0) 编辑

【分享】面试官：简单表述怎么做接口测试

摘要：其实我感觉如果面试官如果问这个问题，他更想考察的是你是不是知道大概的操作流程，用个接口测试工具套下面的流程就好了，我这里拿Eolinker来举例。 1）看接口文档，看看接口的定义，看看是http协议还是https协议，还是别的协议； 2）假如说接口是http协议的接口，再去看是get请求，还是pos 阅读全文

posted @ 2021-04-06 16:46 隔壁王书阅读(239) 评论(0) 推荐(0) 编辑

【分享】接口自动化8问，你考虑了几个？

摘要：自从转了测试岗，感觉身边所有人都在讨论自动化，特别是接口的自动化这几年听得更多。那是不是所有业务都适合自动化？是不是自动化程度越高效果越好呢？下面我也针对接口自动化测试的原理和需要考虑的东西，谈谈自己的看法。为什么要自动化测试? 1)当有太多回归测试工作要做时，请自动化你的测试工作在接口测试阅读全文

posted @ 2021-04-06 15:38 隔壁王书阅读(196) 评论(0) 推荐(0) 编辑

【Eolinker使用】API项目中path的内容如何同步到测试用例？

摘要：这期抽出来的问题是关于API项目中的path如何快速同步到测试用例。 Path我们经常会用到，作用和url类似，效果都是响应返回页面, path调用的是python第三方模块或框架,而url则是自定义的模块。 Eolinker是可以自动生成API文档的，在研发管理模块下的API项目修改path内阅读全文

posted @ 2021-04-06 09:45 隔壁王书阅读(67) 评论(0) 推荐(0) 编辑

【API新闻】为什么Eolinker能在国内的市场风生水起？

摘要：“你的API工具越容易集成，人们就越有可能使用它。” 这是Eolinker的产品经理在SmartBear的专家小组发言时提出的一个简单但关键的想法。该小组聚集了来自API领域的一些专家，讨论了组织开发API战略所面临的挑战和机遇。 Eolinker：国产API研发管理平台，覆盖索尼、电信、360、z 阅读全文

posted @ 2021-04-01 10:44 隔壁王书阅读(118) 评论(0) 推荐(0) 编辑

04 2021 档案

导航

公告

搜索

常用链接

随笔档案