- 综合排序
- 最热优先
- 最新优先
- 来自专栏ThoughtWorks
细说API - 文档和前后端协作
在上一篇文章——《细说API - 重新认识RESTful》中介绍了如何理解和设计RESTful风格的API，现在我们来聊聊如何有效的呈现API文档，以及前后端协作的方式。 API 文档的缺乏给前后端协作带来困难，在缺乏专门工具的情况下，编写和维护文档是一件工作量巨大的事，人工处理也非常容易出错。 本文将会介绍三种方案来解决前后端协作的问题： 基于注释的 API 文档：这是一种通过代码中注释生成 API 文档的轻量级方案，它的好处是简单易用，基本与编程语言无关。 使用契约进行前后端协作：在团队内部，前后端协作本质上需要的不是一份 API 文档，而是一个可以供前后端共同遵守的契约。 围绕着 RAML 这一标准，构建出 API 协作的工具链，设计、构建、测试、文档、共享。 ?
2K30发布于 2019-03-08 - 来自专栏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。 const{title,completed}=req.body;constresult=awaitpool.query('INSERTINTOtasks(title,completed)VALUES($1,$2) =TaskSchema.parse(req.body);constresult=awaitpool.query('INSERTINTOtasks(title,completed)VALUES($1,$2)
41710编辑于 2025-08-31 - 来自专栏研发管理
API测试 | 3步走，通过协作实现API的高质量交付
在高频的迭代节奏中，这些协作上的问题会被不断放大，最终持续影响API的交付质量。想要解决这个问题，就必须从优化团队的协作结构着手。 协作失效：API质量下滑的重要原因自动化工具本应是质量的保障，但由于团队之间的工作流程并未真正打通，依然存在协作的断层。 3步构建API质量的协作体系协作层面的问题，并不会随着部署频率的增加而自动消失，反而会在一次次的快速迭代中被放大。 2、推动前置化的早期协同将QA的角色和视角嵌入到API的设计与开发阶段，能有效地进行风险控制。比如，在API设计评审时，QA可以从可测试性、边界场景、性能负载等方面提出建议。 在软件发布节奏不断加快、服务拆分日益精细的背景下，API已经成为保障系统稳定性和用户体验的关键环节。真正的挑战在于，能否让整个团队围绕着共同的质量目标，形成一套高效顺畅的协作机制。
26010编辑于 2025-10-13 - 来自专栏国产
用了这个API协作调试工具，忘记了postman
开始使用时感觉比较好的功能1、所有数据同步在云端，即使更换电脑，也可以通过浏览器使用（安装插件即可）；2、定义好API文档，就可以开始调试、Mock、自动化测试，非常方便；3、区分测试环境，因为我的项目多而杂 tos-cn-i-k3u1fbpfcp/3d02e8157a8944a4bd451693b8b5e059~tplv-k3u1fbpfcp-zoom-1.image" alt="" width="30%" />4、API 和之前工具的对比，以及对Apifox的建议之前使用过几款API调试工具，Postman等，它们给我的感觉是大同小异的，可以满足基本的接口调试工作，但是并没有我觉得很亮眼的功能，当然也有可能是我还没有接触到比较高级的操作
65220编辑于 2022-10-11 API 在线调试工具：助力高效开发与团队协作
Apifox 并非仅仅是另一个简单的调试器，它是一个集 API 文档管理、API 调试、API Mock 服务以及自动化测试于一体的综合性协作平台。 这意味着，开发者可以在一个统一的环境下完成 API 的设计、调试、模拟和自动化测试，极大地优化了工作流程，促进了前端、后端及测试团队之间的紧密协作。 简洁易用，协作无忧： Apifox 的界面设计简洁直观，操作逻辑清晰。其在线分享 API 文档的功能，省去了团队成员之间反复导出和传输文档的麻烦，让信息传递更加即时高效。 在线调试及协作平台，其设计理念充分考虑了国内开发者的实际需求，致力于简化 API 的测试和调试流程，从而有效提升开发效率与项目质量。 除了文中提及的功能，它还提供了更为完善的团队协作和项目管理特性，方便团队成员共享文档，协同推进项目。如果您正寻觅一款强大而易用的 API 调试工具，Apifox 绝对值得您深入体验。
69810编辑于 2025-09-23- 来自专栏云霄雨霁
Jalangi2 API
MyAnalysis /user/ ksen / Dropbox / jalangi2 / src / js /运行/ analysisCallbackTemplate。 js,第101行 这个文件是编写定制的Jalangi 2分析的模板。简单地复制这个文件并重新编写您需要在分析中实现的回调。其他回调应该从文件中删除。 在以下方法中(也称为回调)可以选择不返回任何东西。 Jalangi 2为运行时加载的每个JavaScript脚本分配了一个唯一的id，称为sid。J $.smap将每个sid映射到一个对象，称为iids，其中包含了id为sid的脚本的源映射信息。 result，isOpAssign，isSwitchCaseComparison，isComputed）{Object | undefined} /Users/ksen/Dropbox/jalangi2/ ，right，isOpAssign，isSwitchCaseComparison，isComputed）{Object | undefined} /Users/ksen/Dropbox/jalangi2/
1.5K00发布于 2018-05-30 - 来自专栏python3
ansible python api 2
最近想利用python来调用anbile来实现一些功能，发现ansible的api已经升级到了2.0，使用上比以前复杂了许多。 utilizing the ``json`` callback plugin or writing your own custom callback plugin """ def v2_ "stdout_lines": [ "Sat Nov 5 21:48:38 CST 2016" ] } } 指定单台执行命令： >>> test2 961 908 \nSwap: 4047 3 4044 " } } 这里可以从输出中取到输出结果： >>> stdout = test2[ （已解决，参考更改过的exec_ansible脚本） -------后续更新--------------- 注： 新版本的api相关模块已经修改，故使用方法上也需要整改，本文档的例子已更新api
2.3K10发布于 2020-01-06 - 来自专栏MasiMaro 的技术博文
WinSock2 API
---- title: WinSock2 API tags: [WinSock, 网络编程, WinSock2.0 API, 动态加载, WinSock 异步函数] date: 2018-07-21 在Winsock中为此而专门提供了一个高效传输文件的API——TransmitFile。 API。 要加载WinSock API，首先需要将第二个控制码参数设置为SIO_GET_EXTENSION_FUNCTION_POINTER，表示获取扩展API的指针。 ，利用这个SOCKET，这个函数以及它返回的API真正做到了与协议无关。
1.5K10发布于 2018-08-31 - 来自专栏研发管理
统一、测试、协作：3方向解析API Hub的高效API管理方案
版本混乱、信息滞后、协作割裂等问题逐渐成为企业数字化转型的障碍。传统零散的管理方式难以应对这种变化，迫切需要一个能够集中管理 API 全生命周期的平台。 SmartBear的API Hub（前身是SwaggerAPI） 它整合了设计、文档、测试和协作功能，为企业提供更高效和安全的 API 管理模式。 统一的API设计：从源头确保一致性API Hub 为 API 生命周期建立了“唯一真实来源”，让团队从设计阶段就能保持一致性。 开发人员无需改变日常习惯，就能让设计、代码与测试结果统一同步到 API Hub 中，实现更高效的跨团队协作。 API 管理早已超越了单纯的网关或监控，它需要覆盖完整生命周期的集中式平台，并能在协作与效率之间取得平衡。SmartBear 的 API Hub 正是这样一个面向未来的选择。
32510编辑于 2025-09-09 - 来自专栏Java架构师历程
2、使用 API 网关
例如，图 2-1 展示了在 Amazon 的 Android 移动应用中滚动产品信息时所看到的内容。 ? 这是一个智能手机应用，产品详细信息页面展示了许多信息。 API 网关封装了内部系统架构，并针对每个客户端提供一个定制 API。它还可用于认证、监控、负载均衡、缓存和静态响应处理。 图 2-3 展示了 API 通常如何整合架构 ? API 还可以为每个客户端提供一个定制 API。它通常会为移动客户端暴露一个粗粒度的 API。例如，考虑一下产品详细信息场景。API 网关可以提供一个端点 /productdetails? productid=xxx，如图 2-3 所示，一个使用了 API 网关的微服务。允许移动客户端通过一个单独的请求来检索所有产品详细信息。 如今，他们使用了 API 网关，通过运行特定设备适配代码来为每个设备提供一个定制 API。 2.4、API 网关的优点与缺点 正如您所料，使用 API 网关同样存在好处与坏处。
2.2K41发布于 2018-09-26 - 来自专栏腾讯技术工程官方号的专栏
【Go API 开发实战 2】RESTful API 介绍
RESTful API 介绍 API（Application Programming Interface，应用程序编程接口）是一些预先定义的函数或者接口，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力 要实现一个 API 服务器，首先要考虑两个方面：API 风格和媒体类型。 Go 语言中常用的 API 风格是 RPC 和 REST，常用的媒体类型是 JSON、XML 和 Protobuf。 REST 是一种软件架构风格，不是技术框架，REST 有一系列规范，满足这些规范的 API 均可称为 RESTful API。 服务器，本教程正是用 REST 风格来构建 API 的。 小结 本小节介绍了软件架构中 API 的实现方式，并简单介绍了相应的技术，通过对比，得出本教程所采用的实现方式：API 风格采用 REST，媒体类型选择 JSON。
1.8K22发布于 2019-05-16 - 来自专栏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')asconn:cursor=conn.execute('SELECT*FROMbooks')books=[{'id':row[0],'title':row[1],'author':row[2] /books.db:/app/books.db关键步骤初始化项目:用Cursor生成Flask和SQLite代码，10分钟搭建API框架。 最终效果效率提升:原计划6小时的任务，2小时搞定，AI省了66%时间。代码质量:输入验证和错误处理让API更可靠，零SQL注入风险。部署顺畅:Docker配置开箱即用，部署到本地和云端零报错。
40710编辑于 2025-08-31 API开发追踪工具：构建高效接口协作体系的核心引擎
在数字化浪潮下，API早已不只是开发细节，而是产品架构与交付效率的关键枢纽。特别是在前后端解耦、微服务架构广泛普及的今天，API的开发、联调、测试和版本管理已成为影响团队协作流畅度的重要因素。 这正是“API开发追踪工具”登场的时机——它们不仅承担接口任务管理职责，更像是一套帮助产品、研发、测试三方协调、共建、共管接口协作体系的中枢系统。 二、接口协作体系中的“权限维度”与权限分级看板类似，API开发追踪同样面临“不同角色应看到不同内容、执行不同操作”的实际需求。 三、API开发追踪的核心流程节点1. 任务拆解与责任人设置每一个API需求都应成为一个独立任务项，配有责任人、交付时间、接口文档入口与状态标记。2. 2. 权限模板设定 + 审计机制为产品/测试/开发设定权限模板，并接入行为日志系统，做到有迹可循。3. 建立API责任制明确每个接口的负责人与验收标准，追踪工具中应内嵌“责任标记”和“验收确认”。
25320编辑于 2025-07-14- 来自专栏小鹏的专栏
tf API 研读2：math
TF API数学计算 tf...... ：math （1）刚开始先给一个运行实例。 tf是基于图（Graph）的计算系统。 (graph=g2) as sess2: print sess2.run(c2) # result: # [ 1.0 ] # [ 2.0 ] （2）tf.a...API： tensor可以是一维 例： a = tf.constant([2, -2, -2, 5],shape=[2,2],dtype=tf.float64) RHS=tf.constant([3,10],shape=[2,1],dtype 例： a = tf.constant([1,2,3,4],shape=[2,2],dtype=tf.float64) b = tf.constant([1,2,3,4],shape=[2,2],dtype z2==>[[1. 2. 3. 4
3.3K50发布于 2018-01-09 Apipost vs Apifox：高效API协作的差异化功能解析
作为经历过多个企业级项目的API架构师，我深刻体会到工具选型对团队协作效率的致命影响。 最近深度使用APIPost和Apifox后，发现了几个令人惊喜的差异化功能，这些特性在实际开发中显著提升了我们的协作质量。 四、接口锁定：团队协作的保险栓在20人规模的跨职能团队中，我们曾因测试人员误改生产环境接口参数导致重大故障。
28800编辑于 2025-04-06- 来自专栏得物技术
得物API一站式协作平台探索与落地
2. = 70// 业务线bweight_b = (60+30)/2 = 45// 业务线cweight_c = (10+0)/2 = 5// 业务线dweight_d = (5+0)/2 = 2.5// 业务线 在Mooncake平台推进的最近三个迭代，同比原有的YApi，人均PV提升2倍，使用时长提升23倍。4.3 提升接口交付质量DTDD最重要的一个核心测试驱动，通过接口文档的测试，保证文档的交付质量。 图片通过对DTDD模式的探索和思考，最终完成了得物一站式文档协作平台的自主研发，Mooncake一站式文档协作平台的上线只是起点，绝不是终点，对于文档平台的展望如下图所示，通过文档协作平台的建设，推动业务发展 总结&思考本文简要给大家介绍了Mooncake作为得物一站式研发协作平台的演进过程。
1.8K110编辑于 2022-10-26 - 来自专栏又见苍岚
ROS2 Python API 介绍
rclpy 提供了用于与 ROS 2 交互的规范 Python API，本文记录相关内容。 简介 rclpy 是 ROS 2（Robot Operating System 2）的 Python 接口，由 Dashing Diademata 发行版开始提供。 跨平台：支持多种操作系统和硬件平台，与 ROS 2 的其他组件一样。 使用 rclpy 可以让开发者在享受 Python 开发效率和生态系统的同时，开发出能在 ROS 2 生态中运行的机器人应用。 参考资料 https://docs.ros2.org/latest/api/rclpy/ 文章链接： https://www.zywvvd.com/notes/tools/ros2/ros2-python-api /ros2-python-api/
1.7K10编辑于 2024-07-13 - 来自专栏Ray学习笔记
RabbitMQ的API参数细节-2
通道绑定对应消息队列和发布消息 参数1：queue表示队列的名称 生产者代码： // 通道绑定对应消息队列 // 参数1：队列名称，如果队列不存在会自动创建 // 参数2：用来定义队列特性是否要持久化 // 参数5：额外附加参数 channel.queueDeclare("hello", false, false, false, null); // 发布消息 // 参数1：交换器名称 // 参数2： "change", null, message.getBytes()); 结论： 同一个通道可以向不同的队列发送消息 basicPublish才是决定消息去什么通道，而不是queueDeclare 2. 队列持久化 参数2：durable 表示队列特性是否要持久化，这里设置为 false，重启RabbitMQ后，所有队列将丢失 // 通道绑定对应消息队列 // 参数1：队列名称，如果队列不存在会自动创建 // 发布消息 // 参数1：交换器名称 // 参数2：队列名称 // 参数3：传递消息额外设置 // 参数4：消息的具体内容 String message = "hello rabbitmq"; //
1.2K30发布于 2021-04-05 - 来自专栏飞鸟的专栏
使用OAuth2保护API
OAuth2是一种授权框架，用于保护API和其他Web资源。它使客户端（应用程序或服务）可以安全地访问受保护的资源，而无需暴露用户凭据（例如用户名和密码）。 以下是使用OAuth2保护API的详细步骤：步骤1：注册客户端 在使用OAuth2保护API之前，客户端必须先在OAuth2服务器上进行注册。 客户端在请求中发送访问令牌，并且API在处理请求时将验证访问令牌的有效性。以下是使用OAuth2保护API的示例：假设我们有一个受保护的API，客户端需要使用OAuth2才能访问该API。 我们将使用以下步骤来保护API：步骤1：注册客户端 客户端需要在OAuth2服务器上注册。 如果访问令牌有效，受保护的API将返回请求的资源。
1.8K20编辑于 2023-04-13 2025 API 开发协作新潮流，先进开发团队及企业如何选择？
Apipost 与 Apifox 作为市场上备受瞩目的两款工具，展现出不同的特质，本文将从API开发的核心功能，协作与团队管理，扩展性、集成与生态格局、AI能力等全方位了解两种工具的不同之处，从而为先进的企业及研发团队如何选择提供方向 协作与团队管理：Apipost 打造高效协同生态 先进开发团队通常具有跨部门、跨地域协作的特点，对协作与团队管理工具的要求极高。Apipost 提供了一套全面且强大的协作解决方案。 其强大的功能体系、深度融合的 AI 能力、高效的协作机制、便捷的用户体验和卓越的性能稳定性，使其成为先进开发团队在 API 开发管理领域的首选工具。 越来越多的先进开发团队正在使用 Apipost 提升研发效率、保障 API 质量、促进团队协作，实现数字化转型与创新发展。 在 2025 年及未来，Apipost 将继续引领 API 开发协作新潮流，助力先进团队在激烈的市场竞争中脱颖而出，创造更多可能。
33710编辑于 2025-06-16
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号