所有文章
> 当前分类:API设计
Go工程化(五) API 设计下: 基于 protobuf 自动生成 gin 代码
2025/10/05
方案设计 开始开发之前我们先看一下 gin 的路由是怎么注册的，以及 grpc 生成的接口格式是什么样的 gin example package mainimport "github.com/gin-gonic/gin"...
为开源项目 go-gin-api 增加 WebSocket 模块
【API设计】
WebSocket 示例界面 第三方包 gorilla/websocket[1] websocket 链接时支持配置项： type Upgrader struct { // 指定升级 webso...
2025/10/04
Arazzo：OpenAPI 的工作流扩展规范
【API设计】
Arazzo 是 OpenAPI 倡议推出的一项新规范，旨在描述和记录 API 中涉及多个操作的复杂工作流。通过声明式的语法，Arazzo 能够清晰地定义操作的输入、输出和步骤，支持复杂的条件判断和引用机制，为 API 文档和测试提供强大支持。
2025/10/04
使用Express.js构建一个简单的RESTful API，处理CRUD操作
【API设计】
在现代Web开发中，RESTful API在前后端分离的架构中扮演着越来越重要的角色。它不仅使得前端和后端能够独立开发，还提高了系统的可维护性和 scalability。今天，我们将一起学习如何使用Express.js构建一个简单的REST...
2025/10/03
使用 ChatGPT 和 json-server 快速实现 mock API
【API设计】
本文翻译自 Rapid Mock API creation with ChatGPT and json-server，点击底部 “阅读原文” 可阅读原文。本文主要介绍如何使用 ChatGPT 和 json-server 快速实现 mock ...
2025/10/02
如何使用JavaScript、Node.js和Express.js构建REST API
【API设计】
我将所有这些经验（好的和坏的）合并成一篇易于理解的文章，同时提供了一个可以遵循的实际示例。最后，我们将构建一个完整的 API，同时实施一个又一个的最佳实践。
2025/10/01
OpenAPI驱动的API设计
【API设计】
OpenAPI 规范是设计 API 的最著名方法之一。OAS 指定了描述 API 接口所需的规则和语法。在撰写本文时，我们使用的是 OAS 的第三个版本。
2025/09/30
Bump.sh 教你在 API 文档中精确调整图像尺寸
【API设计】
Bump.sh新增了图像尺寸调整功能，允许在API文档中通过Markdown扩展语法自定义图像的宽度和高度，提升文档的视觉吸引力和用户体验。这一功能支持精确控制图像显示效果，包括动态GIF和复杂API图表的展示。
2025/09/29
掌握API网关认证：安全连接的可靠方法
【API设计】
在本文中，我们将探讨 API 网关身份验证的基本知识，讨论主要的身份验证方法，并提供实施和克服 API 网关身份验证挑战的指导 - 为您提供保护数字资产安全的知识。
2025/09/29
如何利用Apache APISIX实现高效的API认证与鉴权：全面解析主流认证方式
【API设计】
在当下云原生越发成熟的环境下，API 网关最核心的功能可以概括为：连接 API 消费者和 API 提供者。 实际场景中，除去少部分允许匿名访问的 API 外，提供者往往都会对消费者有所限制，比如只有符合条件的消费者才可以对 API 进...
2025/09/28
API 文档中的技术文档作者角色与必备技能全解析
【API设计】
本文探讨了技术文档作者在API文档中的新角色、必备技能及面临的挑战。技术文档作者通过将复杂技术细节转化为清晰文档，提升开发者体验和API可用性。早期参与API设计能优化API质量，但快速交付和复杂API管理带来挑战。
2025/09/27
Nacos 在 API 网关中的服务发现实践
【API设计】
背景信息 Apache APISIX 是一个动态、实时、高性能的 API 网关，提供负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。它不仅拥有众多实用的插件，而且支持插件动态变更和热插拔。同时在使用服务...
2025/09/27
如何编写v3 AsyncAPI描述
【API设计】
在这篇文章中，我们将通过一个用例示例讨论 AsyncAPI v3.0 提供的主要更改，并描述这如何改进您现有的 API 设计方法。我们将使用此用例创建示例 AsyncAPI 描述，以帮助阐明该方法的优点。
2025/09/26
如何让 Python 写的 API 接口同时支持 Session 和 Token 认证？
【API设计】
Django 是 Python 语言中最受欢迎的 Web 框架之一。其开箱即用的特性，使得我们可以利用它快速搭建一个传统的 Web 应用。在如今多端横行的互联网，单纯的传统 Web 应用开发已经越来越式微，更多的应用采用了前后端分离的 We...
2025/09/25
使用gin搭建api后台系统之框架搭建
【API设计】
gin 是golang 中比较流行的框架，很多系统都是在该框架下开发的，这个框架给我的感觉像是Flask在python中的位置，基础的功能都有，但是如果想要很好的使用，还需要开发很多自己的功能与中间件，在看过不少的教程以后，想要记录一下学习...
2025/09/24
JSON Schema：自定义API响应以提升用户体验
【API设计】
这篇文章将回顾 JSON Schema 的一些不太为人所知的功能，揭示如何利用这些功能让客户端能够自由请求特定字段，并在 API 响应中塑造数据的结构。
2025/09/23
搜索文章
热门话题
文章精选