所有文章 > 当前分类:API设计
Nacos 在 API 网关中的服务发现实践
Nacos 在 API 网关中的服务发现实践
2025/09/27
背景信息 Apache APISIX 是一个动态、实时、高性能的 API 网关,提供负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。它不仅拥有众多实用的插件,而且支持插件动态变更和热插拔。同时在使用服务...
如何编写v3 AsyncAPI描述
如何编写v3 AsyncAPI描述
【API设计】 在这篇文章中,我们将通过一个用例示例讨论 AsyncAPI v3.0 提供的主要更改,并描述这如何改进您现有的 API 设计方法。我们将使用此用例创建示例 AsyncAPI 描述,以帮助阐明该方法的优点。
2025/09/26
如何让 Python 写的 API 接口同时支持 Session 和 Token 认证?
如何让 Python 写的 API 接口同时支持 Session 和 Token 认证?
【API设计】 Django 是 Python 语言中最受欢迎的 Web 框架之一。其开箱即用的特性,使得我们可以利用它快速搭建一个传统的 Web 应用。在如今多端横行的互联网,单纯的传统 Web 应用开发已经越来越式微,更多的应用采用了前后端分离的 We...
2025/09/25
使用gin搭建api后台系统之框架搭建
使用gin搭建api后台系统之框架搭建
【API设计】 gin 是golang 中比较流行的框架,很多系统都是在该框架下开发的,这个框架给我的感觉像是Flask在python中的位置,基础的功能都有,但是如果想要很好的使用,还需要开发很多自己的功能与中间件,在看过不少的教程以后,想要记录一下学习...
2025/09/24
JSON Schema:自定义API响应以提升用户体验
JSON Schema:自定义API响应以提升用户体验
【API设计】 这篇文章将回顾 JSON Schema 的一些不太为人所知的功能,揭示如何利用这些功能让客户端能够自由请求特定字段,并在 API 响应中塑造数据的结构。
2025/09/23
从api.ai工作原理来看构建简单场景chatbot的一般方法
从api.ai工作原理来看构建简单场景chatbot的一般方法
【API设计】 chatbot无疑是当前非常火的一个研究领域和产品方向,简单地可以分为两类,开放域bot和封闭域bot,开放域bot倾向于解决所有的事情,而封闭域bot倾向于解决某一个细分领域中的事情,旨在用AI技术提高效率,提高生产力。现阶段的开放域bo...
2025/09/22
PI 优先设计(API Design-First)全面解析
PI 优先设计(API Design-First)全面解析
【API设计】 API优先设计是一种在编码前先定义API接口的开发方法,旨在通过先规划API合同来确保团队成员对API的理解一致。随着技术的发展,OpenAPI和AsyncAPI分别成为REST API和事件驱动API的描述标准,显著简化了API生命周期。文章回顾了API设计优先的发展历程,从早期的WSDL和SOAP到现代的OpenAPI和AsyncAPI,并探讨了其优势、工具以及设计优先与代码优先的对比。
2025/09/21
如何使用API:初学者的分步教程
如何使用API:初学者的分步教程
【API设计】 了解如何使用 API 对于现代软件开发至关重要,从简单的数据检索到复杂的集成。本指南将揭开该过程的神秘面纱,为您提供发出 API 请求、解码响应以及在代码中安全地实现这些强大连接器所需的见解。您将逐步学习关键概念,这些概念将使您能够在自己的...
2025/09/21
OpenAPI 规范创建指南|优化 API 设计的 10 个关键要点
OpenAPI 规范创建指南|优化 API 设计的 10 个关键要点
【API设计】 本文详细介绍了OpenAPI规范的基本概念及其在API设计中的重要性,包括如何通过10个关键要点来优化API设计。这些要点涵盖了从编写清晰的API标题到定义错误响应模式的各个方面,旨在帮助开发者创建更易于理解和使用的OpenAPI规范。
2025/09/20
通过API集成赋能Autogen Multi-Agent系统
通过API集成赋能Autogen Multi-Agent系统
【API设计】 本文探讨了微软开源的Autogen框架,该框架基于大型语言模型(LLM)构建自治代理(autonomous agents),支持多个代理的协作以实现共同目标。Autogen允许代理进行单聊和群聊,并提供多种发言人选择方法。尽管该框架在实现多个代理的协作方面具有优势,但在将其集成到实际生产环境中(如Web APP)时仍面临一些挑战,如缺乏成熟的文档和资源。 文章详细介绍了如何使用Autogen构建一个基于API的旅游代理系统,包含多个角色的代理,例如旅游代理、位置研究员和用户代理。系统通过与SERP API的交互,允许代理收集和处理用户的旅行需求。最后,文章讨论了在群聊中提高代理协作可预测性和一致性的可能方法,包括修改发言人选择逻辑和使用图模型来强制执行发言者转移路径。 总体而言,文章展示了Autogen在多代理系统中的应用潜力及其在实际应用中面临的挑战与解决方案。
2025/09/20
优化 API 架构的基本策略
优化 API 架构的基本策略
【API设计】 []( 为什么 [API 开发]( API 架构的复杂性。让我们首先看看为什么 API 架构决策很重要。 ![]( ## API 架构的重要性 现代软件生态系统严重依赖 API 及其底层 API 架构。高效API 组件和软件组件的结...
2025/09/19
OpenAPI & AsyncAPI 标签指南:高效组织与优化API文档
OpenAPI & AsyncAPI 标签指南:高效组织与优化API文档
【API设计】 本文详细介绍了如何利用OpenAPI和AsyncAPI标签功能高效组织和分类API端点,提升API文档的结构和可读性。通过示例展示了标签的定义和应用,以及标签排序、使用外部文档链接等技巧,强调了标记所有端点、避免重复标签等最佳实践。
2025/09/18
One-API实现大语言模型请求接口的统一
One-API实现大语言模型请求接口的统一
【API设计】  自ChatGPT发布以来,人工智能大语言模型已经引起了广泛的关注和讨论。而经过最近一两年的发展,很多企业推出了自己的大语言模型:Azure、Anthropic Claude、GooglePaLM2、智谱 ChatGLM、百度文心一言、讯飞...
2025/09/18
Flask-RESTful:最强Python Web服务框架,轻松构建REST API
Flask-RESTful:最强Python Web服务框架,轻松构建REST API
【API设计】 Flask-RESTful:最强Python Web服务框架,轻松构建REST API Flask 是 Python 中最受欢迎的轻量级 Web 框架之一,而 Flask-RESTful 是 Flask 的一个扩展,专门用于快速构建 ...
2025/09/17
理解每种API类型的基本指南
理解每种API类型的基本指南
【API设计】 本文将主要 API 类别细分为开放、合作伙伴、内部和复合。我们还将根据所使用的协议讨论 API 的类型。在本文的最后,您可以放心地选择适合您需求的 API。
2025/09/16
设计多层次API架构:实现优雅编码的简易方法
设计多层次API架构:实现优雅编码的简易方法
【API设计】 本文详细介绍了设计多层次API架构的关键步骤和层次划分,包括控制器层、服务层、数据层、模型层和Utils工具包的设计原则和职责。通过明确每一层的功能和包结构,开发者可以提升项目的可维护性和可扩展性,实现优雅编码。
2025/09/15
1 5 6 7 8 9 17