如何优雅地设计一个 RESTful API

从资源开始

API 的语言应该接近业务，而不是接近数据库表。先识别稳定的资源，再为动作选择清晰的 HTTP 语义。

错误也是产品体验

稳定的错误码、可读的描述和可追踪的请求编号，会让调用方更快解决问题。