-
1 votesanswersviews
对于已执行或不需要的操作,API响应应该是什么
当我的JsonAPI被要求执行已经完成或没有意义的操作时,我应该返回什么响应(代码内容)? 示例:假设我想要一篇文章发布 . 文章草稿通过特定的 endpoints 更新(此处不相关),并且有一个特定的 endpoints 用于发布(我们感兴趣的响应) 4个不同的scenarii,我需要弄清楚每次发送什么类型的响应: 从未请求过出版物,并且该文章包含所有出版物必填信息,请求发布是有意义的,因此... -
4 votesanswersviews
为什么仅为POST请求/ 201(创建)响应设置HTTP位置标头?
暂时忽略3xx响应,我想知道为什么HTTP位置标头仅与POST请求/ 201(创建)响应一起使用 . 来自RFC 2616 spec: 对于201(已创建)响应,Location是请求创建的新资源的位置 . 这是一种受到广泛支持的行为,但为什么不应该将其与其他HTTP方法一起使用?以JSON API spec为例: 它为JSON有效负载(not uncommon for RESTful API... -
6 votesanswersviews
Swagger 2.0中的JSON API示例
我正在尝试使用Swagger 2.0为 endpoints 创建示例响应 . 200: description: Successful response schema: type: object $ref: "#/definitions/User" examples: application/v...