所有文章
> 当前分类:API设计
长时间运行操作的API设计最佳实践:GraphQL对比...
2025/08/20
本文探讨了在现代软件开发中设计支持长时间运行操作的API的最佳实践,通过对比REST和GraphQL两种API设计方法,分析了它们在处理长时间运行操作时的优缺点。文章提供了实际案例,帮助开发者理解异步API的设计原则,特别是在用户体验和技术实现之间找到平衡的关键。
API设计优先与代码优先的比较 – 让你满意的API
【API设计】
本文比较了API设计优先与代码优先两种开发模式的优缺点。代码优先方法虽然适合快速迭代,但常常忽视文档的重要性,导致维护和扩展困难。设计优先方法通过提前定义API结构和行为,确保满足用户需求,支持团队协作和长期维护。文章还探讨了通过注解改进代码优先方法的可能性,以及设计优先与代码共演进的重要性。
2025/08/20
.Net中如何创建RESTful API
【API设计】
RESTful 简介 RESTful 架构可以充分的利用 HTTP 协议的各种功能,是 HTTP 协议的最佳实践。 RESTful API 是一种软件架构风格、设计风格,可以让软件更加清晰,更简洁,更有层次,可维护性更好。 ...
2025/07/27
将api设计为ui与rest端点的权衡
【API设计】
探讨在现代应用开发中将API设计为UI或REST端点的权衡问题,分析两者之间的映射关系及交互方式。文章提出结合键盘优先、上下文感知和丰富交互的API框架设计理念,强调UI与REST API设计的统一性。
2025/06/05
REST API设计开源工具:值得推荐的10+款
【API开发工具】
REST API(Representational State Transfer Application Programming Interface,表述性状态转移应用程序编程接口)是一种软件架构风格,用于设计API网络应用程序。它基于REST原则,允许客户端和服务器之间的交互,使得系统能够通过标准的HTTP操作进行通信和数据交换。
2025/05/19
Swift 3.0 API设计准则
【API设计】
基本要素 把能够清晰使用作为你设计时最重要的目标。因为代码的可读性比代码自身更重要。 代码的清晰逻辑性比代码的简洁性更重要。Swift代码的简洁性,不是指使用最少的字符来实现程序代码。Swift编程的简洁性带来的一个副作用是由...
2024/12/25
60张手绘高清大图理清支付系统最核心的概念
【API设计】
支付系统因其专业性,术语或概念稍为晦涩不好懂。而我向来喜欢“一图胜千言”,所以为支付系统相关的概念画了300多张手绘风格的图,摘录部分供各位参考。 极致简化,真实的实现会复杂非常多。 1. 账户分类 在账务系统中,...
2024/12/24
API 设计:从基础知识到最佳实践
【API设计】
引言 应用程序编程接口(APIs)是现代软件开发的支柱。它们使得不同的应用程序能够无缝地通信和共享数据,从而有效地集成不同的系统和服务。无论您是为个人项目构建一个简单的API,还是为企业级应用程序构建一个复杂的API,遵循良好的API...
2024/12/23
基本 API 设计模式:打造卓越 Web 服务的指南
【API设计】
[]( 在[构建 API]( 时,开发人员面临一个关键挑战:如何确保 [API]( 的结构既易于使用,又具有长期可扩展性。[API 设计模式]( Web 服务的路线图。本指南将解开这些模式,为您提供将 API 转变为良好设计的典范所需的方...
2024/12/21
使用这些基本 REST API 最佳实践构建出色的 API
【API设计】
说到 REST API 最佳实践,很难理解什么是重要的,什么是不重要的。这意味着开发人员在应用最佳实践构建出色的 API 时需要即时、适用的指导。本文将深入探讨优化 REST API 设计的技术,以提高清晰度、稳定性和速度。了解如何通过战略...
2024/12/21
如何在记录 3scale API 网关的 API 调用时获取客户和应用程序上下文
【API设计】
由于 API 处理大量不同类型的数据,因此对于任何数据提供商来说,关键问题是如何具体地保护这些数据。身份验证方法使开发人员能够构建满足其所有需求的应用程序,确定谁可以访问 API 以保护敏感数据并确保请求不会被篡改。身份验证是实体证明身份的...
2024/12/21
成为一名优秀 API 产品经理的良好特质有哪些
【API设计】
随着越来越多的公司意识到 API 优先思维的好处并将 API 视为产品,对良好API 产品管理实践的需求也与日俱增,以使公司的 API 战略成为现实。然而,API 产品管理是一个相对较新的领域,人们对什么是 API 产品管理以及 PM 应该...
2024/12/21
Windows远端线程执行任意API的设计与实现
【API设计】
一摘要 在本进程空间内我们可以做很多事,毕竟是自己的地儿。比如调用SetProcessDPIAware设置一下自己进程的DPI模式,调用GetWindowLongPtr(hWnd, GWLP_WNDPROC)获取本进程所创建窗口的窗口...
2024/12/19
API设计:从REST到RPC
【API设计】
RESTful API RESTful API是一种设计思想,它与具体的实现方式或技术无关。但是,目前最流行的RESTful API大多采用JSON数据格式,并且使用HTTP方法。一个典型的RESTful API应具备以下特征: ...
2024/12/19
从 API 设计开始,了解一下 Golang 的新框架 Twirp
【API设计】
1. 打破单体架构 直到前些年的时候,构建应用程序的首选方法还是做一个单层且不可分割的单元,用它来处理多个互相关联的任务。这就是单体(Monolith)模式。 这种模式在过去是最常见的,如今许多场景下它依旧有很好的效果,并且业内...
2024/12/19
最流行的 RESTful API 要怎么设计?
【API设计】
RESTful 是目前最流行的 [API 设计规范]( Web 数据[接口的设计]( [RESTful 的设计]( [API]( ## URL设计 ### 动词+宾语 RESTful的核心思想就是,客户端发出的数据+操作指令都是“动词...
2024/12/19
热门话题