Network 测试人员 API 设计者 前端开发 网络生态 后端开发 API 文档 1. 可视化的接口文档管理 2. 支持数据结构定义，多接口复用相同数据结构 3. 接口文档完全遵循 OpenAPI 规范 4. 支持在线分享接口文档 API 数据 Mock 1. 零配置即可 Mock 出非常人性化的数据 2. 内置 Mock.js 规则引擎 3. 支持自定义期望，灵活配置根据不同参数值 业务代码和接口请求代码 2. 支持等 130 种编程语言及框架 3. 支持自定义代码模板，满足各种个性化的需求 数据导入/导出 1. 支持导出 OpenAPI (Swagger)、 Markdown、Html 等数据格式 2. 支持导入 OpenAPI (Swagger)、 Postman 等 10 多种数据格式 团队协作 1. 接口数据云端同步，实时更新 2. 成熟的团队/项目权限管理，满足各类企业的 数据切换到正式数据，联调通常都会非常顺利，因为前后端双方都完全遵守了接口定 义的规范。 接口文档设计 接口文档设计 1.完全可视化 2.零学习成本 3.遵循 OpenAPI 规范 数据模型 1.完全可视化 2.支持模型之间嵌套引用 3.支持 JSON/XML 智能导入 4.遵循 JSON Schema 规范 5.支持 oneOf、allOf 等高级 组合模式 接口文档 接口用例/接口调试

Apifox，一体化 API 协作平台 秉承 “API First” 的先进理念，为 API 的开发协作带来全新体验 过去的 API 协同 ❌ 可视化程度低，学习成本⾼ ❌ ❌ 接⼝数据没有统⼀规范 ❌ 多系统，数据不互通 多⼯具切换，团队难以协作 可视化设计，⼩⽩都会⽤ ⼀个系统，同⼀份⽂档⼀次定义，⾃动同步 多⼈协作，实时反馈，合作更紧密 ⾃动化程度⾼，提⾼开发⼈员⽣产⼒ 以⼀致性提⾼软件的质量，简化企业 Markdown 公开⽂档站点 ⾃定义域名 ⾃定义样式 密码保护 Fox 脚本引擎 团队协同 历史修改记录 多⼈实时编辑 API 设计 可视化编辑 请求模版 多环境配置 响应示例 兼容 OAS 规范 数据模型 分⽀管理 Coming soon API Hub Git 代码仓库 可视化设计 本地导入 远端导入 数据源 代码编辑 Coming soon 兼容 Postman 多协议⽀持 根据数据模型的定义，一键生成响应示例，清晰直观，便 于理解。 可复用实体组件化 数据模型、响应、请求参数/请求体组件化，兼容 OAS 组 件规范。 API 文档：所见即所得，妙笔生花 可视化设计，零学习成本 覆盖 API 定义与 Markdown 文档的可视化编辑界面，与 OpenAPI 规范兼容。 公开 API 文档站点 可自定义域名和页面布局，快速创建产品级的 API 站点， 直接嵌入官网向用户分发。

[Github ] https://github.com/apache?q=servicecomb ServiceComb Toolkit Toolkit - 遵循OpenAPI的微服务开发、改造工具 提供遵循OpenAPI规范的API、代码、文档相互转换和校 验的能力，帮助用户快速构建基于流行微服务框架和编程 模型的微服务脚手架工程，提升遗留系统重构、开发效率 • 项目地址 https://github https://github.com/apache/servicecomb-toolkit/blob/master/samples/README-ZH.md 用户 第三方 输出 遵循OpenAPI规范 API文件 代码与API 一致性比较报告 API文档 基于ServiceComb/SpringCloud 微服务工程 用户交互 转换 微服务开发框架 API提取 代码生成 文档生成 运行环 境 验收微服务 协同实现基于契约（API）的数据、服务标准化管控 划分微服务 （含依赖关系） 定义契约 （接口和模型） 发布契约 微服务 运行环 境 验收微服务 基于OpenAPI规范 全新微服务开发 遗留应用微服务化改造 Maven 插件 [Website] http://servicecomb.apache.org [Github ] https://github

servicecomb.apache.org 用户输入 第三方 输出 OpenAPI规范契约文件 契约与代码一致性校验报告 契约（接口）文档 异构微服务项目工程 （ServiceComb 或 SpringCloud） 遗留应用代码 (SpringMVC/POJO/JAX-RS) 契约文件 （符合OpenAPI规范） 用户交互 转换 微服务工程构建 CLI命令行 Maven/Gradle • 契约生成微服务工程：一键生成基于ServiceComb/SpringCloud的微服务工程。 • 代码提取契约：一键从基于SpringMVC/POJO/JAX-RS编程模型开发代码提取OpenAPI契约。 • 契约校验：一键校验实际代码的实现是否与约定契约一致性。 • 契约/代码生成文档：一键制作html文档。 5 github.com/apache?q=servicecomb servicecomb 服务通信规范 配置 流行微服务框架 可视化监控 分布式追踪 遗留应用转型 全新微服务开发 开发工具 代码自 动生成 契约自 动提取 契约校验 文档自 动生成 微服务脚手架 快速入门 案例代码库 用户手册 社区网站 开源异构微服务兼容 内核 服务中心 微服务开发框架 TCC&Saga 分布式事务框架 认证框架 配置中心 多语言方案 Rest(OpenAPI) / RPC

数据切换到正式数据，联调通常都会非常顺利，因为前后端双方都完全遵守了接口定 义的规范。 谁在使用 Apifox 接口文档设计 接口文档设计 1. 完全可视化 2. 零学习成本 3. 遵循 OpenAPI 规范 数据模型 1. 完全可视化 2. 支持模型之间嵌套引用 3. 支持 JSON/XML 智能导入 4. 遵循 JSON Schema 规范 5. 支持 oneOf、allOf 等高级 组合模式 支持自定义代码模板，自动生成符合自己团队的架构规范的代码，满足各种 个性化的需求。 支持 CI/CD • 支持命令行方式运行接口测试 (Apifox CLI)。 • 支持集成 Jenkins 等持续集成工具。 数据导入/导出 • 支持导出 OpenAPI (Swagger)、Markdown、Html 等数据格式。 • 支持导入 OpenAPI (Swagger)、Postman、HAR、RAP2、JMeter、YApi、

契约定义为语言中立 • 规范化系统接口，让实现与文档的同 步成为必须 • 通过工具简化整个过程 API First 增速微服务开发 --- 工具支持 OpenAPI (Swagger) 定义 编辑器：在线编辑，语法提示， 错误检查 文档生成器：生成HTML与符合 华为规范文档 Mock生成器：生成Mock工具， 用于测试微服务 现有代码提取 OpenAPI工具 与RPC的IDL互 微服务 ServiceComb 开发框架 通信模型 (序列化、传输协 议） 编程模型 （同步、异步、 Reactive…) 服务契约 （OpenAPI） 服务发现 熔断 负载均衡 配置 跟踪 … 运行模型 还远远不止这些… 部署/启 调试 微服务 流水线 资源管理 容器编排 & 调 度 应用管理 弹性伸缩 灰度发布 监控运维APM Go语言 XXX语言 Java语言 服务契约 & OpenAPI SpringMVC JAX-RS RPC编程 REST通讯 XX通讯插件 RPC通讯 TCC XX事务 强事务 多语言 多编程框架 多通信协议 多事务一致性

加密 验签 拦截 校验 安全 性能 并发 幂等 交易 缓存 基础服务 消息 监控 配置 报警 MIS OpenAPI 微信 财富圈 移动后台 商城MIS WAP … … Android/ios/h5/php/openApi 积分系统 基础服务 优惠券 宜人币 基金服务 保险服务 网贷服务 支付中心 用户中心 电子签章 人脸识别 营销平台 埋点 服务�A� 1� 服务�B� 2� 移动服务C 接入层 服务A 服务B 1 2 移动服务 接入层 v2 v3 v1 重要原则 幂等、接口可重入 接口规范化(命名、类型、长度等) 分布式事务，补偿、撤销机制 接口缓存，热数据尽可能前置 DB跟随服务 代码、逻辑、结构等都要适时重构 最终架构[简版] OS/网络/存储/防火墙... 应用/框架/业务逻辑/系统间调用 自研日志监控[轻量无侵入] Kafka Kafka Spout 策略 Cache 系统配置 预处理bolts Data Filter 规范化 校验 监控核心流水线bolts RBAC User Role 策略发生器 异 步 线 程 分 发 分布式队列(报警系统) 合并降级 报警队列 活动监控 活动队列 报警策略 系统异常

户使用的易用性问题，业务层主 要解决服务发现和配置管理的功能问题，内核层解决分布式系统⼀致性、存储、高可用等核心问题， 插件解决扩展性问题。 Nacos 架构 < 18 用户层  OpenAPI：暴露标准 Rest 风格 HTTP 接口，简单易用，方便多语言集成。  Console：易用控制台，做服务管理、配置管理等操作。  SDK：多语言 SDK，目前几乎支持所有主流编程语言。 中对于两种实例的健康检查机制。 Nacos 架构 < 92 临时实例健康检查机制 在 Nacos 中，用户可以通过两种方式进行临时实例的注册，通过 Nacos 的 OpenAPI 进行服务注 册或通过 Nacos 提供的 SDK 进行服务注册。 OpenAPI 的注册方式实际是用户根据自身需求调用 Http 接口对服务进行注册，然后通过 Http 接 口发送心跳到注册中心。在注册服务的同时会注册⼀个全局的客户端心跳检测的任务。在服务⼀段 时间没有收到来自客户端的心跳后，该任务会将其标记为不健康，如果在间隔的时间内还未收到心 跳，那么该任务会将其剔除。 SDK 的注册方式实际是通过 RPC 与注册中心保持连接（Nacos 2.x 版本中，旧版的还是仍然通过 OpenAPI 的方式），客户端会定时的通过 RPC 连接向 Nacos 注册中心发送心跳，保持连接的存 活。如果客户端和注册中心的连接断开，那么注册中心会主动剔除该 client 所注册的服务，达到下 线的效果。同时

架构培训 关键 技术 培训 服务化培训 服务化培训 案例 培训 研发&运维团队 微服务划分 微服务 开发 微服务测试 微服 务运 维  规范制定：微服务命名规范、微服务API定义规范、微服 务验收规范、微服务运维和治理规范…  技术选型：统一的微服务框架技术选型，涵盖微服务框架 、微服务流水线（CI/CD）、微服务自动化运维和部署框架  组织赋能：拉通设计、开发、测试和运维的跨团队培训、 Gitter: https://gitter.im/ServiceCombUsers/Lobby 没有十全十美的微服务框架，适合的才是最好的  微服务API设计：支持Swagger API规范  开发方式：支持透明RPC、Spring MVC风格的微服务开发  编程模型：同时支持同步、异步的编程模型  性能：支持原生的Reactive模式（EventLoop），相比于传 统 http://servicecomb.incubator.apache.org/ Gitter: https://gitter.im/ServiceCombUsers/Lobby 遵循OpenAPI Specification，消费端、提供端只依赖API  API描述：无论Rest API，或者RPC Highway API，统一使用Swagger YAML定义API  微服务

捷起来，快速、小批量的交付价值需求，提升业务的交付效率  践行API First：通过服务化，让服务提供者和消费者乊间通过微服务API建立契约，利 用Swagger OpenAPI规范，最终将微服务API规范化、标准化、在线化。系统从传统单体 应用的黑盒调用（本地Java方法调用）转变成透明的API契约调用  服务自治：通过在线的微服务治理结合云平台，可以实现微服务的弹性伸缩、故障自劢 人员是一个很大 的挑戓  线上业务发生故障时，需要对故障业务做服务降级、流量控 制、流量迁移等，快速恢复业务  随着开发团队的丌断扩大，服务的上线越来越随意，上线容 易下线难，为了规范服务的上线和下线，在服务发布前，需 要走服务预发布流程，由架构师戒者项目经理对需要上线的 服务做发布审核，审核通过的才能够上线 服务治理目的：满足服务上下线管控、保障微服务的高效、 健康运行