标签归档rest

HTTP 状态码 410 Gone 以及它是否值得使用

Chris Yue No Comments

今天搬运狂人阮一峰了一篇关于异步 API 设计的文章。很佩服阮老师坚持不懈的搬运工作,比我这三天打渔两天晒网牛逼多了。

表名和目录名是用单数好还是用复数好

Chris Yue No Comments

刚开始一个新的项目,总是满怀憧憬和激动万分的。也许你已经对整个系统架构有了精妙的构思,想象自己就快升职加薪迎娶白富美了,但实际你却还在纠结——或者跟团队争论——这用户表是叫 “user” 呢还是叫 “users” 呢?API 里提供的会员列表应该是 /user 还是 /users ?如果你跟我一样,只想赶紧升职加薪迎娶白富美,那么我们可以在开始下一个项目之前,提前讨论一下这个世纪难题(真的是世纪难题,stackoverflow 上关于此问题的讨论也非常多)。

REST风格的筛选以及批处理操作

Chris Yue 3 comments

设计 REST 风格的查询 URL 是一件很头疼的事情。举个例子,如果想搜索已有文章 article 集合中 tag 是 rest 的文章,你的 URL 设计可能是 /article/tag/rest/,但是如果还要搜索其中 2011 年发布的文章,URL 就变成了类似 /article/tag/rest/year/2011/ …,可想而知,当查询条件越来越多的时候,URL 能有多么的verbose and ugly(想像一下淘宝的商品筛选……),并且筛选条件在 URL 中的顺序也是一个问题(/article/tag/rest/year/2011/ vs /article/year/2011/tag/rest/

2018年十二月
« 10月  
 12
3456789
10111213141516
17181920212223
24252627282930
31