前言
REST API可以设计出更加简洁明了的接口,帮助实现系统之间的信息传递和调用关系。已经设计过并开发对接过银行和银联的API,一直用给方法命名的方式来命名接口,也一直在思考怎么能更高效简洁的定义API。这个规范可以借鉴参考,刚刚好正中下怀,解答了我的很多困惑。
总结思考
1. REST简单说为了实现为了获取资源信息或对其实施动作的规范。从发出请求方式,到返回内容格式,以及动作完成后资源。
2. 原来的设计接口过程中,用了太多v+n的组合。目的是为了给自己提醒也为了方便对接的开发,看来可以借鉴REST,但不能直接全盘套用。虽然用GET和POST方法就可以区分是插入还是查找行为,但是和你对接的人也要接受这样的规则才行。
3. 关于classes和schools的层级,目前所参与的项目都无法自定义url,只有gateway.do一个层级。所有的接口相当于平铺一层,根据的参数中method用名称来区分。