所有文章
> 当前分类:API设计
基于NodeJS的KOA2框架实现restful API网站后台
2025/10/21
在此前写的文章“从零基础入门进行小程序开发实战”中,已经介绍过背单词的小程序,因为没有备案的服务器资源只能使用系统后台提供的缓存功能存储用户数据。缓存有大小限制,而且只提供key-value的存储方式,使用起来也很不方便。 最近域名和...
集成DeepSeek-V3.1开源模型的平台API设计
【API设计】
📖 引言 随着大模型进入「多模态 + 工具链」时代,开发者对「低门槛、低延迟、低成本」调用开源模型的诉求越来越强烈。 DeepSeek-V3.1 作为 2025 年 6 月发布的 236B MoE 架构开源模型,在 MMLU、C-Eval ...
2025/10/20
优化 ASP.NET Core Web API 性能方法
【API设计】
优化 ASP.NET Core Web API 性能 开发人员嗨,构建高性能的 ASP.NET Core Web API 非常重要。它可以帮助用户享受更快的交互并降低服务器成本。本文将指导你了解 ASP.NET Core Web AP...
2025/10/18
常用的14条API文档编写基本准则
【API设计】
您的API 文档受众是细分的。因此,确定从您的文档中受益的不同人群非常重要。这将让您深入了解如何满足他们的需求。
2025/10/17
使用 Keycloak 与 API 网关保护你的 API
【API设计】
OpenID Connect 又名 OIDC,是基于 OAuth 2.0 的认证协议。它允许客户端从身份认证服务 IdP 获取用户基本信息,常见的 IdP 有:Keycloak、Ory、Okta、Auth0、Authing 等。 开源...
2025/10/16
阿里研究员谷朴:API 设计最佳实践的思考
【API设计】
谷朴 | 作者 「 阿里巴巴云原生」授权 API 是软件系统的核心,而软件系统的复杂度 Complexity 是大规模软件系统能否成功最重要的因素。但复杂度 Complexity 并非某一个单独的问题能完全败坏的,而是...
2025/10/15
如何使用DBAPI快速搭建自己的API平台
【API设计】
在工作中,我们需要将数据库中的数据以api接口的形式返回json数据。这需要根据实际情况写相关的接口。不同的平台,选择的语言不尽相同。那么有没有更加简单的方法呢? 关于 DBAPI是一个面向数仓开发人员的低代码工具,只需在页面...
2025/10/14
Go工程化(四) API 设计上: 项目结构 & 设计
【API设计】
序 在 Go 工程化(二) 项目目录结构 中我们大概讲了一下 api 目录,但是并没有详细的说明,留在这这篇文章一起讲。 API 设计将分为四个部分: 首先会讲一下 API 的项目目录结构,在项目中 api 该如何组织,...
2025/10/13
Java 生鲜电商平台 – API 接口设计之 token、timestamp、sign 具体架构与实现
【API设计】
一:token 简介 Token:访问令牌access token, 用于接口中, 用于标识接口调用者的身份、凭证,减少用户名和密码的传输次数。一般情况下客户端(接口调用方)需要先向服务器端申请一个接口调用的账号,服务器会给出一个ap...
2025/10/12
OpenAPI 和 JSON Schema:何时使用哪个
【API设计】
许多组织都有由 JSON Schema 描述的现有对象。但问题是,开发人员遇到了一个大问题:OpenAPI仍然无法识别和支持某些 JSON Schema 关键字。
2025/10/11
API 设计 101:从基础知识到最佳实践
【API设计】
API设计是指设计应用程序编程接口(API)的过程。API是软件系统之间交互的桥梁,允许不同程序或系统通过一组预定义的规则和功能进行通信。设计API时,需考虑功能完整性、易用性、安全性和可扩展性。它定义了接口的结构、数据格式、操作方法等,确保开发者能高效、安全地调用功能,从而实现软件组件之间的无缝协作,提升软件开发效率和质量。
2025/10/10
用WhatsApp API发OTP验证码最全指南
【API设计】
在使用互联网应用程序的过程中,完成用户身份验证往往是必不可少的环节。常见的身份验证是在应用注册、登录、忘记密码等操作中,系统会向用户的手机发送一条验证码短信,并要求用户将验证码输入到相应的输入框中,从而完成身份识别操作。看起来虽然简单,但设...
2025/10/09
API 合同完整指南|设计、最佳实践与自动化应用解析
【API设计】
本文深入探讨了API合同的作用、其对业务的帮助、设计时的最佳实践以及实际应用示例。API合同确保开发人员能够以一致且可预测的方式与API交互,提升API的一致性和可靠性,简化开发流程、提高文档质量,并支持自动化测试。
2025/10/08
全面解析RESTful API设计规范:最佳实践与细节指南
【API设计】
RESTful 是目前最流行的 API 设计规范,用于 Web 数据接口的设计。它的大原则容易把握,但是细节不容易做对。本文总结 RESTful 的设计细节,介绍如何设计出易于理解和使用的 API。 # URL设计 动词+宾语 ...
2025/10/08
vue 中 Axios 的封装和 API 接口的管理
【API设计】
一、axios的封装 在vue项目中,和后台交互获取数据这块,我们通常使用的是axios库,它是基于promise的http库,可运行在浏览器端和node.js中。他有很多优秀的特性,例如拦截请求和响应、取消请求、转换json、客户端...
2025/10/07
API 方法全解析|RESTful 开发者入门与最佳实践
【API设计】
本指南为开发者提供了REST API方法的全面介绍,包括GET、POST、PUT、DELETE、PATCH、OPTIONS和HEAD等HTTP方法的核心特性及其应用场景。特别强调了正确选择API方法的重要性,如重发验证邮件应使用POST而非GET,以避免副作用。适合初学者系统学习API设计和开发。
2025/10/07
搜索文章
热门话题