所有文章 > 当前分类:API设计
Flask-RESTful:最强Python Web服务框架,轻松构建REST API
Flask-RESTful:最强Python Web服务框架,轻松构建REST API
2025/09/17
Flask-RESTful:最强Python Web服务框架,轻松构建REST API Flask 是 Python 中最受欢迎的轻量级 Web 框架之一,而 Flask-RESTful 是 Flask 的一个扩展,专门用于快速构建 ...
理解每种API类型的基本指南
理解每种API类型的基本指南
【API设计】 本文将主要 API 类别细分为开放、合作伙伴、内部和复合。我们还将根据所使用的协议讨论 API 的类型。在本文的最后,您可以放心地选择适合您需求的 API。
2025/09/16
设计多层次API架构:实现优雅编码的简易方法
设计多层次API架构:实现优雅编码的简易方法
【API设计】 本文详细介绍了设计多层次API架构的关键步骤和层次划分,包括控制器层、服务层、数据层、模型层和Utils工具包的设计原则和职责。通过明确每一层的功能和包结构,开发者可以提升项目的可维护性和可扩展性,实现优雅编码。
2025/09/15
Flask-Limiter:为 API 添加访问速率限制的 Python 扩展!
Flask-Limiter:为 API 添加访问速率限制的 Python 扩展!
【API设计】 今天要给大家介绍一款在构建安全且稳定的 API 服务时非常实用的 Python 扩展——Flask-Limiter。它就如同一位严谨的 API 流量管家,能够精准地控制对 API 端点的访问速率,无论是防止恶意攻击、保护服务器资源,还是确保...
2025/09/15
使用README风格的API文档提升您的API设计
使用README风格的API文档提升您的API设计
【API设计】 本文探讨了使用README风格的API文档如何提升API设计,通过关注用户实际工作流而非单个操作,显著提升API的可用性和用户体验。文章介绍了OpenAPI规范的基础,传统API文档的局限性,以及如何实施README风格的文档,包括确定用户工作流、提供代码示例和与现有工具集成。
2025/09/14
REST API 设计:过滤、排序和分页
REST API 设计:过滤、排序和分页
【API设计】 无论 API 是公开的还是内部使用的,API 设计正在成为 API 产品策略的核心支柱。良好的 API 设计可以改善任何 API 程序的整体开发人员体验 (DX),并且可以提高性能和长期可维护性。
2025/09/14
API 架构图指南:类型、工具与最佳实践详解
API 架构图指南:类型、工具与最佳实践详解
【API设计】 API架构图是API开发中不可或缺的工具,提供系统交互的可视化表示,帮助团队管理和维护系统。本指南详细介绍了API架构图的类型、创建工具及最佳实践,包括序列图、服务架构图和内部API架构图等,以及使用UML、Mermaid和Lucidchart等工具的技巧。
2025/09/14
Python人工智能学习路线(长篇干货)
Python人工智能学习路线(长篇干货)
【API设计】 本文篇幅较长,干货较多,建议收藏慢慢看。 适用人群:面向于AI领域了解不深、有自学兴趣且有一些基础知识(高中+)的同学。 谈到人工智能(AI)算法,常见不外乎有两方面信息:铺天盖地各种媒体提到的高薪就业【贩卖课程】、知乎上热门...
2025/09/13
GraphQL 授权层的复杂性及 Hasura 的解决方案
GraphQL 授权层的复杂性及 Hasura 的解决方案
【API设计】 本文探讨了构建GraphQL API授权层的复杂性,包括数据建模、角色定义、嵌套规则和性能优化,并介绍了Hasura的声明式授权解决方案如何通过谓词下推技术简化实现。
2025/09/12
API可观察性:需要监控的5个指标
API可观察性:需要监控的5个指标
【API设计】 在这篇文章中,我们将深入探讨 API 可观察性的各个方面、它为何重要以及要监控的 5 个关键指标。
2025/09/12
从Flask到FastAPI的平滑迁移
从Flask到FastAPI的平滑迁移
【API设计】 迁移 Flask 服务器以获得更好的性能和可维护性。 本文最初发布于 BetterProgramming,经原作者授权由 InfoQ 中文站翻译并分享。 本文将介绍 FastAPI 背后的基本概念,以及将 Flask 服务器过渡...
2025/09/11
如何在API中使用和记录多态 – Bump.sh
如何在API中使用和记录多态 – Bump.sh
【API设计】 本文探讨了在API开发中应用和记录多态性的方法,通过减少重复代码来提升API的可维护性和灵活性。文章通过住宿租赁系统的示例展示了如何利用多态性设计通用端点,简化API结构,并详细介绍了在JSON Schema、OpenAPI和AsyncAPI规范中记录多态性的关键方法。
2025/09/10
REST API接口命名的最佳实践
REST API接口命名的最佳实践
【API设计】 如果您正在构建自己的 REST API,您应该熟悉一些命名 REST API 端点的行业最佳实践。
2025/09/10
API开发流程:从设计到部署的完整指南(含代码示例)
API开发流程:从设计到部署的完整指南(含代码示例)
【API设计】 本文全面探讨了API开发流程,从需求分析到设计、开发、测试、部署和维护,详细介绍了每个阶段的关键步骤和最佳实践。通过一个用户管理API的示例,展示了如何使用Node.js和Express框架实现RESTful API,并提供了代码示例和测试方法。文章还涵盖了API的安全性设计、性能优化以及部署策略,强调了API开发流程中每个环节的重要性。无论是初学者还是经验丰富的开发者,本文都能为理解和掌握API开发流程提供实用的指导和参考。
2025/09/09
长时间运行操作的 API 设计最佳实践:GraphQL 与 REST
长时间运行操作的 API 设计最佳实践:GraphQL 与 REST
【API设计】 我最近读了一篇文章,其中作者指出 GraphQL “不适合长时间运行的操作”。我想证明 GraphQL 可以很好地用于长时间运行的操作。 我们还将看看如何使用传统的 REST API 解决此类问题并比较这两种方法。我们最终会看到的是 ...
2025/09/08
构建高效API的10个API设计最佳实践
构建高效API的10个API设计最佳实践
【API设计】 API 设计的艺术错综复杂,需要仔细平衡技术敏锐性、远见和以用户为中心的设计原则。通过遵循这 10 项最佳实践,您不仅仅是在构建 API;您还在打造一种体验,一种用户与您的应用程序交互的网关。
2025/09/07
1 2 3 15