一、API管理的痛点
随着API经济发展越发壮大,API安全问题可以说已经进入稳定控制状态,如何管理好API成了凌驾于API安全的一项重要工程。API接口管理目前遇到的最大痛点大概就是:开发时编写的大量文档在开发过程中需要经常改动,文档维护工作量由此变大。
做AIP接口开发的都知道,开发文档编写好之后,实际代码通常与文档有些许差别,想要保持代码与文档同步需要消耗很大的工作量。之后若接口版本需要更新迭代,文档势必也要更新迭代,而接口调用本身具有依赖性,很大程度会成为接口开发人员对接时候的阻碍。比如前端调用后端接口但功能无法实现,前端开发进度因此受到影响,特别是当接口变多时,调用、测试等工作复杂程度将消耗巨大的工程量,这过程太艰难。
二、解决思路
目前最行之有效的解决办法是将API接口管理系统化或平台化,也就是可以在可见的界面上直接管理和维护接口,同时这些可见界面的接口可以直接生成相应的代码,这样就能节省大量的开发工作量。当然,更优化的办法是每当代码有变动时,界面上的接口都可以进行同步更变,这样就解决了接口调用方和服务方对于接口依赖的问题。
具体实行思路可以是这样:在可见的API管理界面上提供可模拟实现调用的功能,而且模拟最好能做自定义规则的模拟返回,这样API接口的调用方就可以很方便地基于接口管理系统互平台进行模拟调用,待体验满意方可直接申请真是调用,这样就简化了对接流程,节省了很多沟通解释的时间。最值得注意的是,若接口平台能够支持自动化测试,可以自定义测试案例,然后自动化测试并生成可视化报告,那么将在旧版本接口复测起到关键性作用。
三、解决方案
目前,打通了API接口的大部分公司面临的难题之一就是API的管理问题,然而在API管理上其实很多现成的东西是完全可以拿来用的。现介绍一二:
1.使用在线管理平台
在线管理平台一般会提供API管理、API测试、API监控、API文档管理等综合性API服务,这些平台功能相对完善,API的大部分管理要求一般都能满足,且操作也相对简单。缺点可能就是有的平台没有代码同步功能或自动化测试,较高一点的要求可能无法实现,虽然免费但体验不好。较好的国内平台有:EasyAPI、eoLinker、DOClever
2. 寻求第三方合作
这里的第三方指的是专门做API开发服务的第三方,如果你调用的是他们的API接口,那么就可以直接享受他们的管理系统。这些第三方API管理系统的最大优点就是专业、强大,因为他们是做API开发的,那些API管理、API测试、API监控、API文档等配套管理是必须有的,此外那些在线免费平台没有的高精尖管理功能也是他们的一大亮点,使用它们的接口管理系统最大的好处就是放心。当然,他们也有缺点,那就收费,毕竟人家就是靠这些来养活自己的。较好的国内平台有:赛合一数据、聚合数据、斑马数据
领取专属 10元无门槛券
私享最新 技术干货