AsyncAPI 3.0 - 备忘单
Bump.sh 推出了 AsyncAPI 3.0 备忘单,作为其 OpenAPI备忘单的补充。该备忘单以 PDF 格式提供,并遵循 CC BY-NC-SA 4.0 许可,提供采用 AsyncAPI 规范和文档实践的基本资源,并以 JSON Schema 和 Avro 格式提供示例。
我对于 GraphQL 的看法是错误的
本文反映了作者对 GraphQL看法的变化。作者最初对直接在线公开 GraphQL 持谨慎态度,并且更喜欢 JSON-RPC 层,但现在他意识到在 GraphQL 生态系统中工作的好处。本文强调,GraphQL 的主要优势在于支持联合,这解决了跨团队和服务的 API 开发中的组织挑战。
OpenAPI Overlay 规范简介
本文介绍了 OpenAPI Overlay 规范,这是一种标准化 OpenAPI 描述更新的工具。Overlay 使用带有操作对象的 JSON 或 YAML 文档来定义更改,通过 JSONPath 定位支持“更新”和“删除”操作。这有助于自动更新、治理执行和 API 描述的一致性。提供了在 OpenAPI 文档中更新服务器信息的示例,展示了 Overlay 在整个 API 生命周期中的多功能性。
十年 API 战略的经验教训
本文分享了十年来构建有效 API 平台的经验见解。它强调了跨职能协作、使 API 策略与业务目标保持一致、获得高管支持以及投资文档和培训以创建让合作伙伴和客户受益的成功 API 平台的重要性。
OpenAPI Overlays 可避免 API 过度共享
本文探讨了如何使用 OpenAPI Overlays 来管理 API 过度共享和编辑。它建议维护详细的 API 描述,并使用 Overlays 排除不适合外部公开的部分,例如已弃用或实验性的端点。这种方法有助于 API 管理和维护,同时允许为不同的受众提供定制的 API 描述。
Schema-first:AsyncAPI 只是一个配置文件
本文探讨了 API 开发中设计优先和代码优先方法之间的争论,并指出了这两种方法的挑战。它提倡对 AsyncAPI 采用架构优先方法,其中 AsyncAPI 文件充当代码和文档的配置文件,解决了传统设计优先和代码优先方法中发现的问题。
转向 API 平台思维
本文强调了从以 IT 为中心的方法向以业务架构驱动的 API 平台思维模式的转变。它强调 API 需要与业务目标、用户需求和利益相关者的旅程保持一致,而不仅仅是公开内部系统,以创建一个推动业务价值和创新的有凝聚力的 API 生态系统。
2025 年 API 推广者愿景
本文概述了整合 API 操作各个方面(从业务策略到技术实施)的全面方法。该愿景旨在通过提供故事、指导和讨论来弥合产品与工程之间的差距,这些故事、指导和讨论展示了 API 治理、生命周期管理和最佳实践的业务价值。
API 平台的支柱
本文讨论了 API 支柱的概念,这些支柱是 API 平台的基础和方向的指导原则。它确定了 API 战略与治理、API 管理和 API 运营中的八个关键支柱,强调了它们在将组织目标与技术执行相结合以实现长期成功方面的作用。
关于描述字符串的真相
本文介绍了在 API 文档中描述字符串的最佳实践,强调了向开发人员提供清晰、全面的信息的重要性。它建议详细说明字符串特征,例如长度、允许的字符和 Unicode 支持,并使用示例和 OpenAPI 标签来创建满足开发人员需求的文档。
理解 HTTP 431 错误:开发人员指南
当服务器由于标头字段过大而无法处理请求时,就会发生 HTTP 431“请求标头字段太大”错误。本文解释了导致这种情况的原因,例如过多的 cookie 或格式不正确的标头,并提供了清除 cookie、最小化标头和实施标头压缩等解决方案。
什么是 API 经济?
API 经济描述了组织如何使用 API 作为其业务模式的基础,无论是通过公开其 API 还是使用现有 API 来节省时间、快速执行并产生收入。到 2027 年,API 经济预计将对全球经济产生 14.2 万亿美元的经济影响,是全球技术经济的重要组成部分,对各行各业的企业都至关重要。
什么是联合 API 管理?
联合 API 管理是一种半分散式方法,允许组织内的团队管理其 API,同时遵守中央治理原则。此模型平衡了自主性和控制力,使团队能够灵活地进行 API 开发,同时保持整体一致性和标准。
二、Apache Camel
Apache Camel 3 已终止服务
Apache Camel 3.x 已于 3.22.3 版发布后终止其生命周期,这是自 2019 年 11 月以来 78 个版本发布后的 3.x 系列的最后一次更新。鼓励用户过渡到 Camel 4.x 进行新的开发并计划迁移现有应用程序,因为 Camel 3.x 不会有进一步的发布或支持。
Red Hat 版本的 Apache Camel 4.8 中的新功能
Apache Camel 4.8 的 Red Hat 版本对企业集成框架进行了重大改进,例如改进了契约优先 API 开发、优化了 OpenShift 工作流程以及增强了开发人员工具。此版本侧重于灵活性和性能,提供新组件、改进的安全功能以及与云服务的更好集成。
三、Apache Kafka
Apache Kafka 中的队列:增强消息处理和可扩展性
本文探讨了 Apache Kafka 新增队列支持,从而将其功能扩展到流式传输之外。它解释了消息队列和流式传输之间的区别,重点介绍了 Kafka 的新混合模型,该模型结合了两种方法的优点,使 Kafka 更适合各种用例。
四、Camunda
探索 Camunda 8 中面向 Java 开发人员的新功能
Camunda 8 引入了用于流程自动化的云原生架构,为 Java 开发人员提供了改进的可扩展性、开发人员友好的 API 和增强的 BPMN 建模功能。它通过分布式工作流执行和与流行框架的无缝集成解决了现代挑战。
五、MuleSoft
使用 MuleSoft 和 Salesforce 平台事件创建 AsyncAPI
本文介绍如何使用 MuleSoft 和 Salesforce Platform Events 为事件驱动架构创建 AsyncAPI。它介绍了一个涉及将 Salesforce 自定义对象与不稳定的外部系统同步的用例,演示了 Platform Events 和 Salesforce 流程的设置。
使用 Salesforce 平台事件与 CDC 设计 AsyncAPI
本文比较了 Salesforce 平台事件和变更数据捕获 (CDC)事件的 AsyncAPI 规范设计。它重点介绍了消息结构、渠道命名约定和自定义选项的差异,强调了理解这些区别的重要性。
探索 MuleSoft Composer 的功能
MuleSoft Composer 是 Anypoint Platform 中的无代码平台,允许用户通过点击而不是代码来构建流程自动化和集成。它提供内置连接器,支持实时和计划集成,并支持简单的数据转换和映射。
使用 MuleSoft 的 GraphQL API 指南
本文讨论了 GraphQL 如何通过允许客户端在单个查询中请求特定数据来改变 API 设计。MuleSoft 的 GraphQL APIkit 提供了自动搭建和智能路由等功能,使开发人员能够在 MuleSoft 生态系统中实现和保护 GraphQL API。
六、Tyk
使用 Tyk 构建内部开发者门户
本文介绍如何使用开源 API 网关和管理平台 Tyk 构建内部开发者门户。它涵盖了设置 Tyk 帐户、导入 API、托管页面、保护门户以及监控 API 使用情况,并重点介绍了 Tyk 企业开发者门户的优势。
七、合并与收购
Boomi 收购 Rivery,增强数据管理
Boomi 宣布收购 Rivery,后者是一家以变更数据捕获技术闻名的数据集成提供商。此次收购旨在增强 Boomi 的数据管理能力,使该公司能够更好地满足数据驱动决策时代的企业需求。
八、版本发行
Apache Camel 4.9
Apache Camel 4.9 已发布,具有新功能和改进,包括对 Camel Core、DSL、测试功能、JBang 集成、Kubernetes 支持、可观察性服务和各种组件升级的增强。
Kaoto 2.3
Kaoto 2.3 已发布新功能,包括用于 Camel 路线中图形数据映射的 Kaoto DataMapper 技术预览、改进的画布设计以及对更多 Camel 版本的支持。
Kong Gateway 3.9
Kong Gateway 3.9 引入了扩展的 AI 支持和增强的安全功能,包括通过 Hugging Face 集成支持超过 100 万个新的 AI 模型和改进的 AI 代理工作流程。
Kong Ingress 控制器 3.4
Kong Ingress Controller 3.4 版本包含简化的 TLS 加密、改进的可扩展性以及 Kong Custom Entities 支持的普遍可用性等新功能,标志着 3.X 系列中的第一个长期支持版本。
Tyk 5.7
Tyk 5.7 引入了 Tyk Streams,用于事件原生 API 管理、平台治理增强、高级审计日志功能以及 Tyk Cloud 的遥测改进,支持异步 API 以及传统 REST 和 GraphQL 端点。
九、库包
API 产品管理 101:从基础到高级策略(作者 Joe Maven)
本书为 API 产品经理提供了实用的建议、真实示例和工具,指导他们完成 API 生命周期、用户友好的设计创建和 API 生态系统扩展,同时强调策略、协作和适应性。