7、在线接口文档沟通

项目场景:

新增多个接口,但是用离线版的word文档,进行沟通,如果对接口内容有更改,就会导致频繁的发送文档


问题描述

新增多个接口,但是用离线版的word文档,进行沟通,如果对接口内容有更改,就会导致频繁的发送文档


原因分析:

看项目要求,如果是研发者使用,可能会使用一些在线文档,但是大部分都是需要离线文档,进行存档的


解决方案:

  1. 找一个在线文档
  2. 每次有修改,都告诉对方
  3. 如果涉及主键,外键等等这些,不要只截图,有时候截图会不全
  4. 双方的研发者都需要多沟通
  5. 多沟通,准没有错
  6. 可以讲解业务场景,或者接收数据之后,应该怎么做
  7. 最终拍板是对方,不是你
相关推荐
Miao1213114 分钟前
微服务 API 测试实践:海外某民宿平台如何构建模式驱动测试基础设施
java·开发语言
CRMEB系统商城1 小时前
开源自建还是SaaS订阅?算一笔3年经济账
java·大数据·开发语言·开源
keyipatience3 小时前
线程栈与TLS和线程互斥
java·linux·服务器·开发语言·ubuntu
weixin_408099673 小时前
2026 图片去水印 API 接口完全指南:一键去除图片水印(附 Python/Java/PHP/C# 示例)
java·python·php·图片处理·api调用·图片去水印·石榴智能
钱六两3 小时前
#3、SpringAI 接入deepSeek大模型(喂饭版)
java·spring boot·ai编程
null_175 小时前
IntelliJ IDEA 极致流畅配置方案:Ultra 9 285K + 64GB 内存实测
java·ide·intellij-idea
Herbert_hwt5 小时前
建立Java程序开发
java·开发语言
好好沉淀5 小时前
@ExcelIgnoreUnannotated 和 @AutoMapper 详解
java
愚公移码5 小时前
蓝凌EKP18产品:流程虚拟机(PVM)
java·开发语言·前端
驰骋工作流5 小时前
流程引擎BPM设计之:流程消息
java·工作流引擎·bpm·jflow·ccflow