所有文章 > 当前标签:OpenAPI
为什么你不应该忽略内部API文档的重要性
为什么你不应该忽略内部API文档的重要性
2024/09/13
优秀的文档可让您的团队了解每个 API 的功能并快速上手。这是更大规模 API 设计管理流程的一个重要成果。实施后,您的内部 API 文档可为您的团队提供即时和长期价值。
API治理:有效API管理的最佳实践和策略
API治理:有效API管理的最佳实践和策略
【API生命周期】 API 治理是一个复杂且多方面的过程,涉及多个关键组件,包括安全性、技术、合规性、利用率、监控、性能和教育。通过在这些领域中实施最佳实践,组织可以确保他们的 API 既安全又高效,符合相关规范,并能为用户提供最大价值。
2024/09/11
API 发现:你需要了解的一切
API 发现:你需要了解的一切
【API生命周期】 在本博客中,我们将探讨 API 发现的基础知识,包括其含义、识别已记录和隐藏 API 的技术以及发现对于安全性和效率的重要性。
2024/09/06
使用 OpenAPI 和 Prism 模拟回调
使用 OpenAPI 和 Prism 模拟回调
【API开发】 回调是服务为响应某个操作而向其他服务发出的传出异步请求。它们与 JavaScript 等流行编程语言中的回调函数非常相似。但它们是在 API 抽象级别执行的。
2024/09/06
如何编写 API 文档:最佳实践和示例
如何编写 API 文档:最佳实践和示例
【API开发】 什么是 API 文档?应该如何编写?应该包含哪些内容?最佳实践是什么?本文将回答这些问题,并提供一些创建 API 文档的最佳实践。
2024/08/29
API 开发人员对 API 设计和微服务的见解
API 开发人员对 API 设计和微服务的见解
【API设计】 无论您是使用 API 公开服务,还是在自己的软件架构中使用,拥有最新且易于访问的文档都很重要。
2024/08/25
OpenAPI驱动的API设计
OpenAPI驱动的API设计
【API设计】 OpenAPI 规范是设计 API 的最著名方法之一。OAS 指定了描述 API 接口所需的规则和语法。在撰写本文时,我们使用的是 OAS 的第三个版本。
2024/08/16
精通约定优先API开发:关键策略与优势
精通约定优先API开发:关键策略与优势
【API设计】 在本文中,我们将深入探讨什么是约定优先API开发,它的好处,以及如何有效地实施它。
2024/08/01
2024 年 API 面貌将发生的 4 种变化
2024 年 API 面貌将发生的 4 种变化
【API是什么】 在本文中,我们将探讨 2024 年我们对 API 的看法可能发生的四大转变,以及这些转变对 API 优先企业的意义。
2024/05/24
OpenAPI vs Swagger:哪个更适合您的开放API文档设计
OpenAPI vs Swagger:哪个更适合您的开放API文档设计
【API设计】 本文将围绕OpenAPI和Swagger在数据传输、企业应用场景、适用范围这三大方面进行对比。
2024/05/13
OpenAPI vs RAML vs API Blueprint,谁是最后的赢家?
OpenAPI vs RAML vs API Blueprint,谁是最后的赢家?
【API开发】 如果您是MuleSoft开发人员,您仍然可以选择使用RAML和OpenAPI。如果您是Apiary开发人员,您也可以选择使用API Blueprint和OpenAPI。然而,OpenAPI拥有更多的采用率、更丰富的生态系统和更多的社区支持。
2024/03/04
全面解读:REST API与OpenAPI的区别、应用及最佳实践指南
全面解读:REST API与OpenAPI的区别、应用及最佳实践指南
【API术语解释】 REST API是一种基于REST架构风格的API,遵循无状态、可缓存等原则,通过HTTP方法操作资源;而OpenAPI是一种API描述规范,使用JSON或YAML格式定义API的结构和行为,旨在实现API的标准化描述和自动化处理。REST API与OpenAPI的关系类似于SOAP API与WSDL的关系,OpenAPI为REST API提供了标准化的描述框架,通过OpenAPI可以实现API的自动化文档生成、客户端代码生成以及服务端代码验证等功能。
2024/03/02