说实话，我最近翻看了一下自己几年前写的接口代码，那叫一个惨不忍睹啊。GET、POST随便用，接口响应格式五花八门，URL设计完全是想到哪写到哪。要不是现在要给新同事交接，我都不好意思再看第二眼。

正好趁这个机会，我打算好好聊聊REST API这个话题。老实说，这个概念我也是用了好几年才真正开始理解，从一开始的完全不在意，到后来被各种规范搞得焦头烂额，再到现在算是找到了一个相对舒服的实践方式。

先别急着规范，聊聊REST是怎么来的

很多教程一上来就给你甩一堆规范，什么HTTP动词要合理使用啊，URL要符合REST风格啊...但说实话，如果不知道这些规范背后的思考，很容易就走到另一个极端：把REST当成紧箍咒，写个接口前还得战战兢兢地翻文档。