API开发的痛点分析

API无具体规范：导致沟通、联调、接入成本巨大；

API开发无法很好的衔接，开发是把设计文档转译为代码；

API文档不全，导致后期开发维护工作量巨大；

API技术栈很难标准化，多模块集成时经常遇到技术栈版本冲突；

API开发门槛高，需要懂语言、微服务、分布式技术；

API的质量不受控，基本依赖于开发人员技术能力。

API全可视化开发

API契约设计：灵犀平台提供API契约设计，设计人员可以通过可视化设计工具定义API契约，可以定义好API访问路径 、出入参数、调用样例等。后续开发时候遵循契约进行开发。

API契约查询：灵犀平台提供了API市场，所有发布的API都在市场中，在API市场中可以查询到所有开放的API契约，联调、接入时候可以按API市场定义契约。

API在线拨测：灵犀平台API市场还提供了API拨测功能，提供样例直接调用API，可以清晰看到出入参结果，清晰知道入参填写是否正确，免去沟通、联调，让接入者、使用者有更直接的体验。

业务建模：灵犀平台提供灵活多样的业务建模能力，可以根据实际场景选择不同的建模方式。若是新项目，可以直接在灵犀平台上手工建模，或者通过SQL自动创建模型；若是老项目，可以把模型批量导入。

行业模型库：浩鲸还沉淀了系列行业模型，业务建模时可以直接复用已有的行业模型，减少建模工作量。

业务对象设计：业务建模主要是完成数据的物理存储，业务对象提供模型如何跟页面、服务的对接。业务对象设计时候可以定义相关对象关系、对象属性显示规则、对象脱敏设置、对象属性值设置等能力。

API处理逻辑可视化：编排出的API处理逻辑是一个可视化的流程图，整个API的处理逻辑一目了然。从需求人员和设计人员维度，通过流程图很容易知道需求在开发落地中业务处理逻辑是否有问题。从客户角度，通过流程图可以掌握业务的实际处理逻辑，清晰了解到业务逻辑是否正确，实现知识的自主掌控。对于后续接手人员来说，代码即文档，能够快速上手，免去钻研代码的痛苦。

API拖拽式开发：点击API处理流程，可以在流程上增加处理环节，提供20+的组件供选择。包括我们编程中使用的程序控制逻辑、数据操作、访问外部服务、集成规则、集成业务流程、集成函数或自定义代码段、通知等组件。可以满足我们绝大部分API的开发诉求。

API处理逻辑查看：API业务处理逻辑开发完后，提供查询回看功能。可以再查询整体处理逻辑是否正确，每个环节的出入参映射是否正确。

丰富的组件：

API在线调测：API开发完后，点击服务调测功能，调测功能提供API各环节处理链，提供每个环节的出入参、处理耗时、处理详细日志信息。通过调测结果，可以清晰明了看到每个环节的出入参值，可以知道对于环节参数映射是否存在问题。

函数调测：API开发过程的工具箱组件可以提供自定义函数管理，对于自定义的函数也提供在线测试功能。可以输入函数入参对函数进行测试，验证函数返回是否符合开发人员预期。

总结和展望

高效率：业务开发聚焦业务逻辑，无需关注技术；

低成本：通过复用组件和能力，交付周期更短成本更低；通过API处理逻辑可视化展示，降低了后续开发维护成本；

低门槛：无需编程经验，可以全民开发；

高质量：代码基本是自动生成，质量内建；

全程可视化：设计、编码、调测都提供可视化工具；

自主掌控：API处理逻辑以流程图可视化展示，对客户可以实现自主掌控。

API开发的架构：API开发发布后，采用Serverless架构承载；API开发只关注业务，不用关注资源、运行和运维；

API的能力连接器丰富：需要进一步丰富API的能力连接器，提供更多标准化能力，实现更丰富的API业务场景开发；包括消息服务、缓存服务、云能力服务等；

API组件丰富：提供更丰富的API组件，满足更丰富的API业务场景；包括文件处理类、协议转换等。