所有文章
> 当前分类:API设计
万字讲透REST API资源建模
2025/10/30
0 前言 ★ “REST 中信息的核心抽象是资源。任何可以被命名的信息都可以成为资源:文档或图像、临时服务(例如‘今天洛杉矶的天气’)、其他资源的集合、非虚拟对象(例如一个人)等等。换句话说,任何可能成为作者超文本引用目标的概...
API治理:有效API管理的优秀实践和策略
【API设计】
设计良好的API治理框架可以帮助组织建立开发、部署和管理API的指导方针和优秀实践。API治理指的是一组策略、过程和实践,组织采用这些策略、过程和实践来确保对其应用程序编程接口(API)的有效管理和控制。设计良好的API治理框架可以帮助组织...
2025/10/29
API设计:从基础到最佳实践
【API设计】
在这次深入探讨中,我们将深入了解API设计,从基础知识开始,逐步进阶到定义出色API的最佳实践。 作为开发者,你可能对许多这些概念很熟悉,但我将提供详细的解释,以加深你的理解。 API设计:电子商务示例 让我们考虑一个类似...
2025/10/28
22条API设计的最佳实践
【API设计】
曾经因为一个糟糕的API而感到沮丧吗? 在这个微服务的世界里,后端API的一致性设计是必不可少的。 今天,我们将讨论一些可遵循的最佳实践。我们将保持简短和甜蜜——所以系好安全带,出发咯! 首先介绍一些术语 任何API...
2025/10/27
Java API 开发:构建可重用的接口,简化系统集成
【API设计】
Java API 开发:构建可重用的接口,简化系统集成 大家好,我是凯哥!今天我要和大家分享一个非常实用的主题:如何在 Java 中设计和开发出优秀的 API 接口。作为一名经验丰富的 Java 开发者,我深知一个设计良好的 API ...
2025/10/26
IOT语义互操作性之API接口
【API设计】
这个系列文章描述了一个单一的语义数据模型来支持物联网和建筑、企业和消费者的数据转换。 这种模型必须简单可扩展, 以便能够在各行业领域之间实现插件化和互操作性。 对于一个目前从事智能硬件的老码农,觉得这些文字具有积极的参考意义。这一部分讨论通...
2025/10/25
标准API接口设计规范
【API设计】
接口签名 接口签名是一种常见的安全措施,用于确保API请求的完整性和身份验证。 实现步骤 以下是实现接口签名的一般步骤: 参数收集:首先,收集所有将发送到API的参数,包括例如用户ID、操作类型、请求数据等。 ...
2025/10/24
B站微服务API管理
【API设计】
引言 API 管理是应用开发中不可或缺的一部分。在早期服务数量不多的情况下,团队可以自行负责 API 管理。但随着公司规模逐渐扩张,业务接口数量爆炸式增长,此时 API 管理的任务应由统一的接口管理平台来承担,结束各自为政的局面。统一...
2025/10/23
用 AWS Smithy 构建下一代 API 服务
【API设计】
自动化代码生成这种能减少工作量的事情一直是程序员们的最爱。如果某些代码片段不断重复自身,我们会用宏替换来减少这种重复,但如果涉及到大规模,架构级别的重复,那么我们倾向于用代码生成来解决这种重复。日常工作中,大家使用得比较多的代码生成工具有 ...
2025/10/22
基于NodeJS的KOA2框架实现restful API网站后台
【API设计】
在此前写的文章“从零基础入门进行小程序开发实战”中,已经介绍过背单词的小程序,因为没有备案的服务器资源只能使用系统后台提供的缓存功能存储用户数据。缓存有大小限制,而且只提供key-value的存储方式,使用起来也很不方便。 最近域名和...
2025/10/21
集成DeepSeek-V3.1开源模型的平台API设计
【API设计】
📖 引言 随着大模型进入「多模态 + 工具链」时代,开发者对「低门槛、低延迟、低成本」调用开源模型的诉求越来越强烈。 DeepSeek-V3.1 作为 2025 年 6 月发布的 236B MoE 架构开源模型,在 MMLU、C-Eval ...
2025/10/20
API 设计原理:从理论到实践
【API设计】
本文深入探讨了API设计原理,从基本原则到常见模式,再到最佳实践和工具使用,全面解析了如何设计高效、易用且可扩展的API。文章强调了API设计原理中的一致性、简洁性、可扩展性和安全性,并通过RESTful API、GraphQL和RPC等实际代码示例,展示了不同API设计模式的应用场景和实现方法。此外,文章还介绍了Swagger、Postman等工具在API设计和文档生成中的重要作用。通过理论与实践的结合,本文为开发者提供了全面的API设计原理指导,帮助构建高质量的API,提升系统开发效率和可维护性。
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
热门话题