1、使用RPC风格: Users/AddNew、Users/GetAll、Users/DeleteByld
2、对于可以缓存的操作,使用GET请求,
对于幂等的更新操作,使用PUT请求,
对于幂等的删除操作,使用DELETE请求,
对于其他操作,统一使用POST请求。
3、参数: 保存、更新类的请求使用POST、PUT请求,把全部参数都放到请求报文体中;对于GET和DELETE请求,把参数放到QueryString中。推荐尽量使用URL做资源定位。
4、对于业务错误,服务器端返回合适的4XX状态码,不知道该选择哪个状态码就用400;同时,在报文体中通过code参数提供业务错误码以及错误消息。
5、如果请求的处理执行成功,服务器端返回值为200的Http状态码,如果有需要返回给客户端的数据,则服务器端把这些数据放到响应报文体中。