- 综合排序
- 最热优先
- 最新优先
- 来自专栏ThoughtWorks
细说API - 文档和前后端协作
在上一篇文章——《细说API - 重新认识RESTful》中介绍了如何理解和设计RESTful风格的API，现在我们来聊聊如何有效的呈现API文档，以及前后端协作的方式。 API 文档的缺乏给前后端协作带来困难，在缺乏专门工具的情况下，编写和维护文档是一件工作量巨大的事，人工处理也非常容易出错。 本文将会介绍三种方案来解决前后端协作的问题： 基于注释的 API 文档：这是一种通过代码中注释生成 API 文档的轻量级方案，它的好处是简单易用，基本与编程语言无关。 使用契约进行前后端协作：在团队内部，前后端协作本质上需要的不是一份 API 文档，而是一个可以供前后端共同遵守的契约。 围绕着 RAML 这一标准，构建出 API 协作的工具链，设计、构建、测试、文档、共享。 ?
2K30发布于 2019-03-08 - 来自专栏专注数据中心高性能网络技术研发
Chapter 7: The Concurrency API
std::thread的使用场景 需要访问底层线程实现的API时，std::thread能通过native_handle()返回这个句柄 需要优化应用的线程使用时，比如硬件特性和应用的配置文件已知且固定 需要实现一些C++并发API没有提供的线程技术 2. memory std::atomic使得多线程并发访问的顺序得到控制 std::volatile使得编译器不会优化这类变量的代码，因为有些代码在原本的优化规则里面是允许的，但是在逻辑上是不允许进行优化的 7. Summary The std::thread API offers no direct way to get return values from asynchronously run functions
1.2K50发布于 2018-05-26 - 来自专栏linux运维
协作场景：用AI加速TypeScript后端API开发
TypeScriptv5.2.2,PostgreSQLv15.3,Docker24.0.5,AI工具:Cursor(v0.42.0withClaude3.5Sonnet),GitHubCopilot.协作目标 :开发一个TypeScript的Express后端API，用于管理任务（CRUD操作），连接PostgreSQL，要求类型安全、性能稳定，部署到Docker。
41710编辑于 2025-08-31 - 来自专栏研发管理
API测试 | 3步走，通过协作实现API的高质量交付
在高频的迭代节奏中，这些协作上的问题会被不断放大，最终持续影响API的交付质量。想要解决这个问题，就必须从优化团队的协作结构着手。 协作失效：API质量下滑的重要原因自动化工具本应是质量的保障，但由于团队之间的工作流程并未真正打通，依然存在协作的断层。 3步构建API质量的协作体系协作层面的问题，并不会随着部署频率的增加而自动消失，反而会在一次次的快速迭代中被放大。 因此，若要从根本上提升API质量，就必须进行协作优化：1、构建统一的沟通语言这是打破信息壁垒的基础。开发、测试和运维团队需要在质量认知上达成共识。例如，一个测试用例应该包含哪些元素才算结构完整？ 在软件发布节奏不断加快、服务拆分日益精细的背景下，API已经成为保障系统稳定性和用户体验的关键环节。真正的挑战在于，能否让整个团队围绕着共同的质量目标，形成一套高效顺畅的协作机制。
26010编辑于 2025-10-13 - 来自专栏XINDOO的专栏
Agent设计模式——第 7 章：多 Agent 协作
多 Agent 协作模式概述 多 Agent 协作模式涉及设计系统，其中多个独立或半独立的 Agent 协同工作以实现共同目标。 它首先设置环境，从 .env 文件加载 API 密钥。应用程序的核心涉及定义两个 Agent：一个研究员用于查找和总结 AI 趋势，一个作家用于基于研究创建博客文章。 langchain_google_genai import ChatGoogleGenerativeAI def setup_environment(): """加载环境变量并检查所需的 API load_dotenv() if not os.getenv("GOOGLE_API_KEY"): raise ValueError("未找到 GOOGLE_API_KEY。 """ print(f"工具：为提示词生成图像：'{prompt}'") # 在真实实现中，这将调用图像生成 API。 # 对于此示例，我们返回模拟图像数据。
4.5K11编辑于 2025-10-27 - 来自专栏不止dotNET
dotNET 7：最小 API 使用
最小 API 并不是在 .NET 7 中才加入的，记得应该是在 .NET 6 中就已经提供，只是对我来说，到现在才开始使用。 创建一个最小 API 在 VS 2022 中创建 WebAPI 项目，不勾选使用控制器，创建出来的就是最小 API ： 不勾选使用控制器，就会创建最小 API 模板； 启用 OpenAPI ，默认会添加 Random.Shared.Next(summaries.Length)] )) .ToArray(); return forecast; }); //运行 API 依赖注入 依赖注入一个常见的做法是使用构造函数进行注入，传统的 WebAPI 中可以在 Controller 的构造函数中进行，但最小 API 没有 Controller ,下面看看在最小 API 中是怎么注入的 ： app.MapGet("/helloworld", (IUser user) => { return $"hello , {user.GetName()}"; }); 配置 最小 API
1.1K30编辑于 2022-12-01 - 来自专栏国产
用了这个API协作调试工具，忘记了postman
开始使用时感觉比较好的功能1、所有数据同步在云端，即使更换电脑，也可以通过浏览器使用（安装插件即可）；2、定义好API文档，就可以开始调试、Mock、自动化测试，非常方便；3、区分测试环境，因为我的项目多而杂 tos-cn-i-k3u1fbpfcp/3d02e8157a8944a4bd451693b8b5e059~tplv-k3u1fbpfcp-zoom-1.image" alt="" width="30%" />4、API <img src="https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/d1e0263b38b04206b4fa<em>7</em>ebdbd0e348f~tplv-k3u1fbpfcp-zoom 和之前工具的对比，以及对Apifox的建议之前使用过几款<em>API</em>调试工具，Postman等，它们给我的感觉是大同小异的，可以满足基本的接口调试工作，但是并没有我觉得很亮眼的功能，当然也有可能是我还没有接触到比较高级的操作
65220编辑于 2022-10-11 API 在线调试工具：助力高效开发与团队协作
Apifox 并非仅仅是另一个简单的调试器，它是一个集 API 文档管理、API 调试、API Mock 服务以及自动化测试于一体的综合性协作平台。 这意味着，开发者可以在一个统一的环境下完成 API 的设计、调试、模拟和自动化测试，极大地优化了工作流程，促进了前端、后端及测试团队之间的紧密协作。 简洁易用，协作无忧： Apifox 的界面设计简洁直观，操作逻辑清晰。其在线分享 API 文档的功能，省去了团队成员之间反复导出和传输文档的麻烦，让信息传递更加即时高效。 在线调试及协作平台，其设计理念充分考虑了国内开发者的实际需求，致力于简化 API 的测试和调试流程，从而有效提升开发效率与项目质量。 除了文中提及的功能，它还提供了更为完善的团队协作和项目管理特性，方便团队成员共享文档，协同推进项目。如果您正寻觅一款强大而易用的 API 调试工具，Apifox 绝对值得您深入体验。
69810编辑于 2025-09-23- 来自专栏研发管理
统一、测试、协作：3方向解析API Hub的高效API管理方案
版本混乱、信息滞后、协作割裂等问题逐渐成为企业数字化转型的障碍。传统零散的管理方式难以应对这种变化，迫切需要一个能够集中管理 API 全生命周期的平台。 SmartBear的API Hub（前身是SwaggerAPI） 它整合了设计、文档、测试和协作功能，为企业提供更高效和安全的 API 管理模式。 统一的API设计：从源头确保一致性API Hub 为 API 生命周期建立了“唯一真实来源”，让团队从设计阶段就能保持一致性。 开发人员无需改变日常习惯，就能让设计、代码与测试结果统一同步到 API Hub 中，实现更高效的跨团队协作。 API 管理早已超越了单纯的网关或监控，它需要覆盖完整生命周期的集中式平台，并能在协作与效率之间取得平衡。SmartBear 的 API Hub 正是这样一个面向未来的选择。
32510编辑于 2025-09-09 - 来自专栏CU技术社区
【Git学习笔记7】多人协作时要知道的事儿
四、抓取分支 多人协作时，大家都会往master和dev分支上推送各自的修改。 五、多人协作模式 多人协作的工作模式通常是这样： 首先，可以试图用git push origin <branch-name>推送自己的修改； 如果推送失败，则因为远程分支比你的本地更新，需要先用git 这就是多人协作的工作模式，一旦熟悉了，就非常简单。
61920发布于 2019-11-22 - 来自专栏linux运维
协作场景：用AI快速开发一个Python Flask API
Ubuntu22.04,Python3.10.12,Flaskv2.3.2,SQLite3.36.0,Docker24.0.5,AI工具:Cursor(v0.42.0withClaude3.5Sonnet).协作目标 目标是用AI加速代码生成和调试，确保API高效、可靠，减少手动写SQL的时间。 /books.db:/app/books.db关键步骤初始化项目:用Cursor生成Flask和SQLite代码，10分钟搭建API框架。 错误处理:加try-catch和错误响应，API更健壮。Docker部署:用AI生成的Docker配置，30分钟完成部署。测试验证:用Postman压测，50并发下响应稳定在100ms。 代码质量:输入验证和错误处理让API更可靠，零SQL注入风险。部署顺畅:Docker配置开箱即用，部署到本地和云端零报错。
40710编辑于 2025-08-31 API开发追踪工具：构建高效接口协作体系的核心引擎
在数字化浪潮下，API早已不只是开发细节，而是产品架构与交付效率的关键枢纽。特别是在前后端解耦、微服务架构广泛普及的今天，API的开发、联调、测试和版本管理已成为影响团队协作流畅度的重要因素。 这正是“API开发追踪工具”登场的时机——它们不仅承担接口任务管理职责，更像是一套帮助产品、研发、测试三方协调、共建、共管接口协作体系的中枢系统。 一套成熟的API开发追踪工具，应具备以下功能： 任务可视化管理 接口文档同步与变更控制 联调责任分配 权限分级与访问控制 多角色协同支持（产品/开发/测试） 这些能力的结合，使接口开发从“临时协作 二、接口协作体系中的“权限维度”与权限分级看板类似，API开发追踪同样面临“不同角色应看到不同内容、执行不同操作”的实际需求。 四、推荐API开发追踪工具盘点工具名称核心能力适用场景板栗看板轻量任务管理、本地化支持好、权限清晰国内团队协作首选，适合快速部署Jira敏捷管理强，支持插件拓展中大型技术团队多模块并行开发YApi接口文档
25320编辑于 2025-07-14- 来自专栏机器人网
国内首台7自由度协作机器人来了
此次展会新松公司重点发布的新松柔性多关节机器人是国内首台7自由度协作机器人，具备快速配置、牵引示教、视觉引导、碰撞检测等功能，具备高负载及低成本的有力优势，满足用户对于投资回报周期短及机器人产品安全性、 灵活性及人机协作性方面的需求。 相较于市场上出现的同类七自由度协作机器人产品，基于自主研发技术，新松七自由度协作机器人在负载或成本上都优于同类产品。 其极高的灵活度、精确度和安全性的产品特征，将开拓全新的工业生产方式，引领人机协作新时代。 新松公司隶属中国科学院，是一家以机器人独有技术为核心，致力于数字化智能高端装备制造的高科技上市企业。
1.2K40发布于 2018-04-20 - 来自专栏IT技能应用
「Adobe国际认证」改进设计协作，流程的 7 种方法
为了执行有效的设计协作项目，团队需要使用正确的最佳实践和工具来取得成功。这些因素可以使团队保持正轨并促进密切协作。如果没有完善的工作流程和适当的资源集，设计协作可能会过于复杂。 什么是设计协作流程？ 协作设计可以帮助以最小的干扰推进这些高级项目。 开发新的想法和方法 协作设计也有助于产生新的想法。两个头脑总比一个好，这也是设计的常态。 改进设计协作流程的 7 种方法 现在我们对设计协作过程的含义有了更好的理解，让我们探索可以用来改进它的七种技术。 1. 找到并使用正确的工具 我们都知道使用质量不佳的工具的感觉如何。 当您尝试与他人协作时，劣质工具可能会造成特别大的破坏。 您应该使用正确的设计协作工具来协调团队成员之间的工作关系。 7. 津津乐道协作精神 作为人类，我们天生具有高度的社会性和合作性。我们已经进化了数百万年以共同生存和繁荣，这是与他人合作并创造出令人惊叹的东西感觉如此美妙的关键原因之一。
38220发布于 2021-07-08 - 来自专栏∑小熊猫的博客
Zookeeper系列(7) —— Zookeeper 的 Java API
Zookeeper Java API 初始依赖 在使用 Java API 对 Zookeeper 进行操作是，首先需要引入相关的依赖。
75710发布于 2020-11-25 Apipost vs Apifox：高效API协作的差异化功能解析
作为经历过多个企业级项目的API架构师，我深刻体会到工具选型对团队协作效率的致命影响。 最近深度使用APIPost和Apifox后，发现了几个令人惊喜的差异化功能，这些特性在实际开发中显著提升了我们的协作质量。 四、接口锁定：团队协作的保险栓在20人规模的跨职能团队中，我们曾因测试人员误改生产环境接口参数导致重大故障。
28800编辑于 2025-04-06- 来自专栏得物技术
得物API一站式协作平台探索与落地
面临的问题根据行业报告显示，开发团队大概有50%的工作时间是围绕着API开展的，目前在得物的研发流程中，围绕API文档的协同工作分散在不同的工具或者平台，导致现有的API在研发协同工作中低效流转。 测试驱动开发：同步自动化测试平台针对API的测试用例，提高API交付的质量。实现数据Mock：基于API的数据Mock，提升前端、客户端的研发效率。 图片通过对DTDD模式的探索和思考，最终完成了得物一站式文档协作平台的自主研发，Mooncake一站式文档协作平台的上线只是起点，绝不是终点，对于文档平台的展望如下图所示，通过文档协作平台的建设，推动业务发展 基本功能: 围绕API提供基本的功能，例如接口文档、接口测试、数据Mock等解决方案: 围绕API的一些功能，为研发提供解决方案，如研发流程的管理、API的快速生成、接口编排、依赖信息变更等降本提效: 总结&思考本文简要给大家介绍了Mooncake作为得物一站式研发协作平台的演进过程。
1.8K110编辑于 2022-10-26 - 来自专栏腾讯技术工程官方号的专栏
【Go API 开发实战 7】基础 3：记录和管理 API 日志
记录和管理 API 日志 本节核心内容 Go 日志包数量众多，功能不同、性能不同，本教程介绍一个笔者认为比较好的日志库，并给出原因 介绍如何初始化日志包 介绍如何调用日志包 介绍如何转存（rotate
1.6K21发布于 2019-05-16 - 来自专栏WalkingCloud
CentOS7下安装文档协作工具Confluence7.2.1
使用简单，但它强大的编辑和站点管理特征能够帮助团队成员之间共享信息、文档协作、集体讨论，信息推送。 Confluence 不是一个开源软件，非商业用途可以免费使用。 confluence为团队提供一个协作环境。在这里，团队成员齐心协力，各擅其能，协同地编写文档和管理项目。 Confluence的优势 1）企业级的安全性 2）安装简单，易于管理 3）简洁，友好的用户界面 4）强大的构造和搜索功能 5）PDF导出和自动的重构 6）开放的API接口，灵活扩展和集成 Confluence 注释和附件间的搜索 2）组织：高效地创建灵活的页面结构 3）注释：进行小组讨论 4）重获：容易找到你需要的信息 5）导出：页面乃至整个空间可以导出为HTML，PDF，XML文件 6）重构：高效的信息操作 7） MariaDB数据库 yum 方式安装 curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.
2.6K10发布于 2020-07-22 - 来自专栏HelloGitHub
第 7 篇：文章详情的 API 接口
一旦我们使用了视图集，并实现了 HTTP 请求对应的 action 方法（对应规则的说明见 使用视图集简化代码），将其在路由器中注册后，django-restframework 自动会自动为我们生成对应的 API 目前为止，我们只实现了 GET 请求对应的 action——list 方法，因此路由器只为我们生成了一个 API，这个 API 返回文章资源列表。 GET 请求还可以用于获取单个资源，对应的 action 为 retrieve，因此，只要我们在视图集中实现 retrieve 方法的逻辑，就可以直接生成获取单篇文章资源的 API 接口。 访问此 API 接口可以获得指定文章 id 的资源。 文章详情 Serializer 现在，假设我们要获取 id 为 1 的文章资源，访问获取单篇文章资源的 API 接口 http://127.0.0.1:10000/api/posts/1/，得到如下的返回结果
1.5K30发布于 2021-05-14
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号