请问怎么样才能愉快的前后端进行对接

2021-12-09 09:43:01 +08:00
 xianyv

我现在跟前端对接的时候太痛苦了, 怎么才能让前端看到接口就知道这个接口用在哪里? 还有就是怎么才能让前端记住部分通用字典(这个可能有点过分)?

5872 次点击
所在节点    问与答
86 条回复
bojackhorseman
2021-12-09 09:53:46 +08:00
写好文档😏
gauzung
2021-12-09 09:59:45 +08:00
1.让前端看到接口就知道这个接口用在哪里；
2.让前端记住部分通用字典

我的评价是——换个后端
cxe2v
2021-12-09 10:03:13 +08:00
写好文档[微笑]
xianyv
2021-12-09 10:11:24 +08:00
@gauzung 哈哈哈哈,确实这两个要求太过分了
zhuangjia
2021-12-09 10:13:43 +08:00
写好文档
xianyv
2021-12-09 10:15:02 +08:00
@bojackhorseman
@cxe2v 怎么才能算是一个好文档? 因为业务频繁变动,有的时候实在是就把文档更新给忘记了
zhuangjia
2021-12-09 10:17:27 +08:00
1.让前端看到接口就知道这个接口用在哪里
没有默契就在开发前和前端对照设计图确认开发方案，并确保后面接口文档与此一致
2.怎么才能让前端记住部分通用字典
通用字典放到文档里，每个需要该字典的地方都链接过去
h1104350235
2021-12-09 10:17:52 +08:00
写好文档
xianyv
2021-12-09 10:19:53 +08:00
@zhuangjia 好的谢谢
zhuangjia
2021-12-09 10:20:03 +08:00
@xianyv
> 因为业务频繁变动,有的时候实在是就把文档更新给忘记了

前端怼我一句话：你文档没更新，我改不了
cxe2v
2021-12-09 10:21:30 +08:00
@xianyv #6 你都能把文档给忘了，那可不就得口耳相传接口设计了
zinete
2021-12-09 10:21:52 +08:00
我是前端， 有个 swagger docs 链接就成
xianyv
2021-12-09 10:22:34 +08:00
@cxe2v 这点我是需要改改的
xianyv
2021-12-09 10:22:56 +08:00
@zinete 不让用,文档手写
iDontEatCookie
2021-12-09 10:25:32 +08:00
我们后端给我的接口都是 xx 模块 /xx 页面 /xx 时候调用接口 这样写好的 字典要么是在接口参数注释里写好 要么是统一接口返回的

文档不更新 总不能让我看你后端代码接接口吧？
bojackhorseman
2021-12-09 10:33:28 +08:00
我们用的`swagger-typescript-api`根据 swagger json 文件生成 api 文档，类型提示，调用方法都有，特别方便，不用手写方法了。
zoharSoul
2021-12-09 10:34:37 +08:00
让前端自己写接口, 后端写到 rpc 层完事
TangYuSen
2021-12-09 11:01:08 +08:00
昨天上课的老师说了，软件开发中，敲代码只占了很小一部分的时间（他说最多 10%），更多时间是在写文档，开会交流，要我们牢记这点，其实我也赞同，我觉得我周围的人对文档很不重视，只顾敲代码完成功能就完事了，包括我，我自己也在学着去写文档了，但写文档来的正反馈真的没有敲代码完成一个小功能来的爽，感觉写文档，更多的是对自己工作负责吧，我想或许这是成为高级工程师的要点之一吧（我专业是软工）
DShen
2021-12-09 11:06:47 +08:00
自己做全栈😂
deplivesb
2021-12-09 11:08:34 +08:00
锻炼身体，当后端打不过你的时候，他自然能和你愉快的对接

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://tanronggui.xyz/t/821032

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX