所有文章
> 当前分类:API设计
从api.ai工作原理来看构建简单场景chatbot的一般方法
2025/09/22
chatbot无疑是当前非常火的一个研究领域和产品方向，简单地可以分为两类，开放域bot和封闭域bot，开放域bot倾向于解决所有的事情，而封闭域bot倾向于解决某一个细分领域中的事情，旨在用AI技术提高效率，提高生产力。现阶段的开放域bo...
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 请求、解码响应以及在代码中安全地实现这些强大连接器所需的见解。您将逐步学习关键概念，这些概念将使您能够在自己的...
2025/09/21
OpenAPI 规范创建指南｜优化 API 设计的 10 个关键要点
【API设计】
本文详细介绍了OpenAPI规范的基本概念及其在API设计中的重要性，包括如何通过10个关键要点来优化API设计。这些要点涵盖了从编写清晰的API标题到定义错误响应模式的各个方面，旨在帮助开发者创建更易于理解和使用的OpenAPI规范。
2025/09/20
通过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 架构决策很重要。 
OpenAPI & AsyncAPI 标签指南：高效组织与优化API文档
【API设计】
本文详细介绍了如何利用OpenAPI和AsyncAPI标签功能高效组织和分类API端点，提升API文档的结构和可读性。通过示例展示了标签的定义和应用，以及标签排序、使用外部文档链接等技巧，强调了标记所有端点、避免重复标签等最佳实践。
2025/09/18
One-API实现大语言模型请求接口的统一
【API设计】
自ChatGPT发布以来，人工智能大语言模型已经引起了广泛的关注和讨论。而经过最近一两年的发展，很多企业推出了自己的大语言模型：Azure、Anthropic Claude、GooglePaLM2、智谱 ChatGLM、百度文心一言、讯飞...
2025/09/18
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。
2025/09/16
设计多层次API架构：实现优雅编码的简易方法
【API设计】
本文详细介绍了设计多层次API架构的关键步骤和层次划分，包括控制器层、服务层、数据层、模型层和Utils工具包的设计原则和职责。通过明确每一层的功能和包结构，开发者可以提升项目的可维护性和可扩展性，实现优雅编码。
2025/09/15
Flask-Limiter：为 API 添加访问速率限制的 Python 扩展！
【API设计】
今天要给大家介绍一款在构建安全且稳定的 API 服务时非常实用的 Python 扩展——Flask-Limiter。它就如同一位严谨的 API 流量管家，能够精准地控制对 API 端点的访问速率，无论是防止恶意攻击、保护服务器资源，还是确保...
2025/09/15
使用README风格的API文档提升您的API设计
【API设计】
本文探讨了使用README风格的API文档如何提升API设计，通过关注用户实际工作流而非单个操作，显著提升API的可用性和用户体验。文章介绍了OpenAPI规范的基础，传统API文档的局限性，以及如何实施README风格的文档，包括确定用户工作流、提供代码示例和与现有工具集成。
2025/09/14
REST API 设计：过滤、排序和分页
【API设计】
无论 API 是公开的还是内部使用的，API 设计正在成为 API 产品策略的核心支柱。良好的 API 设计可以改善任何 API 程序的整体开发人员体验 (DX)，并且可以提高性能和长期可维护性。
2025/09/14
API 架构图指南：类型、工具与最佳实践详解
【API设计】
API架构图是API开发中不可或缺的工具，提供系统交互的可视化表示，帮助团队管理和维护系统。本指南详细介绍了API架构图的类型、创建工具及最佳实践，包括序列图、服务架构图和内部API架构图等，以及使用UML、Mermaid和Lucidchart等工具的技巧。
2025/09/14
Python人工智能学习路线(长篇干货)
【API设计】
本文篇幅较长，干货较多，建议收藏慢慢看。 适用人群：面向于AI领域了解不深、有自学兴趣且有一些基础知识（高中+）的同学。 谈到人工智能（AI）算法，常见不外乎有两方面信息：铺天盖地各种媒体提到的高薪就业【贩卖课程】、知乎上热门...
2025/09/13
热门话题
