前后端一般都是怎么约定接口的?

[rabbbit]

小作坊,设计稿啥的当然是没有.
基本就是前后端俩人商量,经常因为没说清楚导致总是改来改去,效率极低.自己拿 nodejs 写可能都比俩人写快.

很好奇各位平时都是怎么约定前后端接口的?怎么避免打起来.dog

[louxiaohei]

不约定，先按常规的来，需要再改

[yeqizhang]

搞清楚到底为什么没说清楚吧？

经常改动除非需求变更，一般调好了还会有啥问题呢。

前端也可以提出要什么样格式的数据，由后端去实现，不要一味让后端去给什么数据就说了算。反正我见过很多的前端都是坐等要后端去根据需求给数据，给的不好就各种抱怨....很多前端基本上是自己造成的不了解业务侧。

不管是前端还是后端给出的格式样例，有些复杂的数据，最后由于实现的原因还是会有一些改动。这个很正常

[yeqizhang]

附加一句， 一个需求，前端和后端两个人的水平都决定了做完需要的时间....经验多的，能越早发现问题

[kiritoxf]

用 swagger 简单写个

[rabbbit]

@yeqizhang

例如:
1 后端要求把客服聊天数据存浏览器里,不存数据库,觉得没必要.
2 后台表格需要批量删除数据,但后端只给单独删除的接口.觉得前端可以写个 for 循环调用.
3 订单流程用数值表示.然后顾客完成订单, 退单全走一个接口,传订单值.

经常因为这种事情扯半天

[rabbbit]

传订单值 -> 直接传订单流程数值

[yeqizhang]

@rabbbit 对于一，由提需求的或者领导来决定，一般为了聊天数据存档可查，还是要存到数据库。 二 如果是删除单页多条，应该传多个 id 给后台，说写 for 循环删，这个后台水平一般呀... 三 这个业务我太清楚不好评论。

[Chenamy2017]

我们也是小作坊，两人搞定前后端。基本都是我定的，我是后端。
接口的话首先要搞清楚需求，功能先设计（想好），包括界面大致什么样子，数据大致什么格式，然后再定下接口。
当然了两个人如果还为这些扯半天，说明你们两合作不好。

[treblex]

不要：
1.post 请求在 url 获取参数
2.get 请求传表单数据
3.一个接口，大写 小写 驼峰 下划线 开大会

要：
有文档尽量清楚点，没有的话，字段命名尽量清楚点

就行

[sexman]

swagger

[renmu123]

谁拳头大听谁的（笑:-D ）

[stellar]

这么多年我算是放弃了，不需要啥约定，把接口文档写清楚明白就谢天谢地了，管它咋命名，管它啥格式

[YouLMAO]

你先进入 Apache 技术委员会，再来改我的设计，再提扣你绩效

[amwyyyy]

后端先出接口文档，前端根据文档开发，有问题就提出来协商修改。