- path上一定是写名词,不要写动词
- path上写资源名称
- 动词使用Http的Get Post Put Patch Delete Options 方法来代替
- path上每一个变量的前面一定需要有一个key(名词) 来进行一一对应
- 尽量设计复数的资源,比如key/{api_key}/devicces
- 当复数的资源支持后,单数的资源自然就支持了
- body尽量用Object 不要直接使用Array,Array的扩展性没有Object好
{ devices:[ device1,device2]}
{ devices:[ device1,device2]}