这是个啥风格的 api 啊?

[ChiangKaishek]

整个就一个 /api 接口, 请求方法全写在负载里面 这样写 api 有啥好处吗?

[murmur]

get 方法的 post+json 写法，因为写 www.example.com/api?method=group/list ，首先参数的斜杠要转义有些低端开发是不知道的，徒增烦恼，索性全扔到 post 了，get 部分干干净净什么都不留

全 post 挺好的，能避开很多麻烦

[murmur]

如果他有框架做网关或者自己实现了单入口 /group/list 和 method=group/list ，本质上没区别

[thetbw]

支付宝的接口好像就这样，还有一些移动的接口。那些 to b 的这种蛮多，也不知道为啥

[dzdh]

支付宝：

https://openapi.alipay.com/gateway.do?method=xxx.xxx.xxx&biz_content=json

阿里云：

https://{PRODUCT}.console.aliyun.com/data/api.json?action=ApiName

[dzdh]

阿里基于 springcloudgateway 那一套搞的

[murmur]

@thetbw 多少年前的，大概是 php 年代就开始用的单一入口，那个时候还没有拦截器这么先进的东西，框架页不完善，要自己做一个入口，权限什么的做一做然后分发到业务下，所以路由部分是参数不是 url

[zhuweiyou]

websocket 一般这么玩.

[murmur]

@dzdh 你仔细看，支付宝的页面是做了 IE6 的兼容的，这系统如果是 spring gateway ，除非是我 java 历史需要恶补，不是太超前了

[Onlyil]

网关层统一接入吧，之前公司也是这样

[brader]

类似这种风格，我上次接入 ETH 的 JSON-RPC API 的时候遇到过，https://ethereum.org/en/developers/docs/apis/json-rpc/
感觉没有什么吧，一样用。
然后关于你说的全部请求使用 POST ，其实大部分请求都可以使用 post ，但是有一小部分请求你不得不使用 get ，就是那种需要通过 url 传递参数的场景，比如你分享一个链接给别人之类的

[Tink]

有这样的，以前我们项目就是这么写的

[westoy]

介于 web rpc 和 rest 中间的一种风格

[liut2016]

@murmur #1 post 不是幂等的，不方便缓存，这样是否不太好？

[eason1874]

十几年前，虚拟主机时代，CMS 都这样，现在属于是文艺复兴了。不同的是以前没有网关，现在是有网关，而且是可编程网关

[ChiangKaishek]

@murmur #2 感觉这样好像也没给前后端带来啥好处, 接口可读性感觉还差了.

[thetbw]

@liut2016 api 要啥缓存，基本都要求是实时数据

[dzdh]

@liut2016 #13

是不是幂等和业务有关。post 个 id 后端检测 id 已存在然后不 insert 直接返回成功算不算幂等。

[dcsuibian]

别研究了，这有个鸡儿好处，就是在重新发明 http 罢了

这个 method 明显是拿来做请求分发的——正常直接用 url 就好了，offset 、pageSize 其实用 get 放查询参数里更好。
设计这个的人可能不太了解 http 、restful ，可能是个人喜好，可能是从老师傅那里抄过来的等等。

不是什么大事，毕竟谁还没重复造过轮子呢。

[ChiangKaishek]

@Tink 啥情况下要这样写接口啊？

[bk201]

方便拦截处理吧，放在 path 部分可能不能严格要求格式。