所有文章
> 当前分类:API设计

PHP转Go系列 | ThinkPHP与Gin框架之API接口签名设计实践
2024/11/25
数据安全一直是个热门的话题,API 接口在数据的传输上扮演着至关重要的角色。为了 API 接口的安全性、健壮性,完整性,往往需要将网络上的数据进行签名加密传输。同时为了防止 API 接口被重放爬虫伪造等类似恶意攻击的手段,还要在接口设计时增加有效时间、随机字符串、签名串等参数,来保障数据的安全性。这一次的 API 接口签名设计实践,大家也可以手动尝试实验一下,希望对大家的日常工作能有所帮助。

如何在软件开发中实施API First标准
【API设计】
API 优先方法强调在软件开发生命周期伊始就将 API 设计与创建置于核心地位,将其视为决定其他应用程序代码开发的基础组件,从而确保服务之间的一致性与可重用性,为应用程序带来可扩展性、灵活性以及与微服务架构的无缝集成等显著优势。有效的 API 优先策略实施涵盖全面的文档、标准化的错误处理和强大的 API 治理,这不仅培养了更佳的开发人员体验、激发创新活力,还使得 API 能够在组织内跨不同语言和平台实现无缝交互,支持无依赖项的升级与更新,极大地增强了系统的健壮性与灵活性。尽管在采用 API 优先实践过程中可能存在诸如文化转变、技术多样性管理等挑战,但其带来的显著架构优势不容小觑,能够加快产品上市时间、实现经济高效的应用程序开发,推动组织在激烈的市场竞争中保持领先,引领软件开发迈向更具前瞻性与战略性的新阶段。
2024/11/22

百亿规模API网关服务Shepherd的设计与实现
【API设计】
API网关是随着微服务概念兴起的一种架构模式。原本一个庞大的单体应用(All in one)业务系统被拆分成许多微服务系统进行独立的维护和部署,服务拆分带来的变化是API的规模成倍增长,API的管理难度也在日益增加,使用API网关发布和管理API逐渐成为一种趋势。一般来说,API网关是运行于外部请求与内部服务之间的一个流量入口,实现对外部请求的协议转换、鉴权、流控、参数校验、监控等通用功能。
2024/11/21

我们应该如何用好 AI?从 ChatGPT 到编程语言、大数据、前端
【API产品】
2022 年是科技圈艰难的一年,很少有振奋人心的消息。惊喜的是年底 OpenAI 开放的 ChatGPT,一下点燃了整个科技圈,体验后感觉有点像人脑,智能化程度惊艳。曾经我和朋友常调侃人工智能就是“有多少人工,就有多少智能”,ChatGPT...
2024/11/21

通过API集成赋能Autogen Multi-Agent系统
【API设计】
本文探讨了微软开源的Autogen框架,该框架基于大型语言模型(LLM)构建自治代理(autonomous agents),支持多个代理的协作以实现共同目标。Autogen允许代理进行单聊和群聊,并提供多种发言人选择方法。尽管该框架在实现多个代理的协作方面具有优势,但在将其集成到实际生产环境中(如Web APP)时仍面临一些挑战,如缺乏成熟的文档和资源。 文章详细介绍了如何使用Autogen构建一个基于API的旅游代理系统,包含多个角色的代理,例如旅游代理、位置研究员和用户代理。系统通过与SERP API的交互,允许代理收集和处理用户的旅行需求。最后,文章讨论了在群聊中提高代理协作可预测性和一致性的可能方法,包括修改发言人选择逻辑和使用图模型来强制执行发言者转移路径。 总体而言,文章展示了Autogen在多代理系统中的应用潜力及其在实际应用中面临的挑战与解决方案。
2024/11/21

18个最佳API设计规范实践
【API设计】
文章总结了API设计中应遵循的重要原则。首先强调了签名的重要性,通过将请求参数、时间戳和密钥拼接后进行hash算法处理生成签名,以防止数据被篡改,并通过时间戳限制请求的有效期。在数据安全方面,建议对敏感数据进行加密,如使用AES对称加密算法保护用户密码等重要信息。此外,文章还提出了其他设计要点,包括设置IP白名单以限制访问来源、实施限流策略以避免服务过载、进行严格的参数校验以拦截无效请求、统一返回值和异常处理以简化维护工作、记录详细的请求日志以便快速定位问题、设计幂等接口以避免重复操作、限制批量接口的记录条数以防止超时、进行压力测试以评估接口性能、采用异步处理以提升性能、对敏感数据进行脱敏处理以保护隐私、提供完整的接口文档以降低对接成本、合理选择请求方式、利用请求头传递公共参数、设计批量接口以提高通用性以及遵循职责单一原则以降低维护难度。这些军规旨在帮助开发者设计出更安全、高效、易维护的API接口。
2024/11/21

API性能提升宝典:12个必杀技
【API设计】
本文深入探讨了提升系统性能和优化技术的关键策略,包括并行处理、最小化事务范围、缓存应用、合理使用线程池、服务预热、缓存对齐、减少对象产生、并发处理、异步处理以及循环优化等十二个方面。文章强调了在高并发场景下,通过减少事务范围和合理使用缓存来提升系统响应速度和可靠性。同时,讨论了线程池的配置和监控、服务预热、缓存对齐以及减少对象产生的重要性,这些措施有助于降低系统延迟和提高吞吐量。
2024/11/20

如何设计API 接口的统一格式指南
【API设计】
前言 在移动互联网,分布式,微服务盛行的今天,现在项目绝大部分都采用的微服务框架,前分离分离方式 一般系统的大致整体架构图如下: 需要说明的是,有些小伙伴会回复说,这个架构太简单了吧,太low了,什么网关啊,缓存...
2024/11/20

API 设计最佳实践的深度思考
【API设计】
阿里妹导读:API 是模块或者子系统之间交互的接口定义。好的系统架构离不开好的 API 设计,而一个设计不够完善的 API 则注定会导致系统的后续发展和维护非常困难。 接下来,阿里巴巴研究员谷朴将给出建议,什么样的 API 设计是好的...
2024/11/20

从零开始:如何为你的项目开发自定义API?
【API设计】
在本文中,我们详细探讨了自定义 API 的开发流程,从理解自定义 API 的基本概念,到设计、开发、优化和安全性等方面的关键步骤。通过明确 API 的目标、选择合适的开发工具和技术、实现核心功能等一系列步骤,你已经掌握了如何构建一个符合项目需求的自定义 API。
2024/11/13

REST API手册:如何构建、测试、使用和记录REST API
【API设计】
本教程旨在向您展示如何从零开始构建一个REST API的示例。
2024/10/29

如何设计和开发Web API:开发人员的基本指南
【API设计】
但是应用程序如何相互交互呢?它们通过 API(应用程序编程接口)来实现。在本文中,您将了解什么是 API。我们将特别关注 Web API 及其设计和开发。
2024/10/26

如何使用JavaScript、Node.js和Express.js构建REST API
【API设计】
我将所有这些经验(好的和坏的)合并成一篇易于理解的文章,同时提供了一个可以遵循的实际示例。最后,我们将构建一个完整的 API,同时实施一个又一个的最佳实践。
2024/10/22

设计可用、灵活、持久的 API
【API设计】
在设计 API 之前,首先需要明确其目标用户:是针对内部消费者、客户、第三方开发者,还是以上所有?
2024/10/18

REST API URI 设计的 7 条规则
【API设计】
本文将介绍一组 REST API URI 的设计规则,并探讨如何使用 Keycloak 或客户端证书来保护 REST API 的安全。
2024/10/11

设计第一个 GraphQL 架构的实用指南
【API设计】
本文将回顾在设计 GraphQL 模式时需牢记的一些原则。
2024/10/11
搜索文章
热门话题