REST API 设计通常围绕资源及其表示组织 Web 接口，并利用 HTTP 方法、状态码与缓存等语义表达操作。
资源与协议
可用集合资源表达列表、单项资源表达具体对象。GET 应保持安全语义，PUT、DELETE 的幂等含义与 POST 不同；接口应返回与实际结果相符的状态码，而不是把所有业务结果都包装成不可区分的成功。
演进与边界
实践中需定义分页、过滤、错误结构、字段兼容和版本策略。列表排序需要稳定规则，错误应提供可处理的信息，同时避免暴露凭据或内部细节。
并非 URL 中出现名词就满足 REST 的全部架构约束；也不应为追求形式强行把自然业务操作拆成难以维护的资源组合。