)]}'
{"guidelines/http.rst":[{"author":{"_account_id":6167,"name":"Ken\u0027ichi Ohmichi","email":"ken1ohmichi@gmail.com","username":"oomichi"},"change_message_id":"596bb9f5b7fe74ba8551686d169e335b8491edfd","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* If a call is made which attempts to put a resource into a state which it is"},{"line_number":40,"context_line":"  already in (eg locking an instance which is already locked), the return code"},{"line_number":41,"context_line":"  should be **200 OK**."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Failure Codes"},{"line_number":44,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9af37de9_87fff133","line":41,"updated":"2015-05-11 05:43:50.000000000","message":"This description seems difficult to apply to projects.\n\nThe success status code of the call is 201 or something(except 200), the status code are different based on the resource situation. So clients need to consider it and accept both status codes as success code. It makes difficult to implement client side.","commit_id":"b2fbadad1e8ad4c58968507ce07347b90c0dfbc0"},{"author":{"_account_id":9420,"name":"Matthew Gilliard","email":"matthew.gilliard@hp.com","username":"gilliard"},"change_message_id":"1c46457d680ca384ef737a7f7c80662714f1a4ef","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* If a call is made which attempts to put a resource into a state which it is"},{"line_number":40,"context_line":"  already in (eg locking an instance which is already locked), the return code"},{"line_number":41,"context_line":"  should be **200 OK**."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Failure Codes"},{"line_number":44,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9af37de9_e2110b5f","line":41,"in_reply_to":"9af37de9_62f2bb9c","updated":"2015-05-11 07:33:49.000000000","message":"Done","commit_id":"b2fbadad1e8ad4c58968507ce07347b90c0dfbc0"},{"author":{"_account_id":9420,"name":"Matthew Gilliard","email":"matthew.gilliard@hp.com","username":"gilliard"},"change_message_id":"1c46457d680ca384ef737a7f7c80662714f1a4ef","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* If a call is made which attempts to put a resource into a state which it is"},{"line_number":40,"context_line":"  already in (eg locking an instance which is already locked), the return code"},{"line_number":41,"context_line":"  should be **200 OK**."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Failure Codes"},{"line_number":44,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9af37de9_422c57ab","line":41,"in_reply_to":"9af37de9_87fff133","updated":"2015-05-11 07:33:49.000000000","message":"@Ken\u0027ichi - this seems OK to me. If a client cares only about the success of the call, then 200 \u003c\u003d x \u003c 300 is a suitable check.  I know client writers don\u0027t always think like this though, so I\u0027ll change it to something like:\n\n\"... the return code should be in the 2xx successful range\"","commit_id":"b2fbadad1e8ad4c58968507ce07347b90c0dfbc0"},{"author":{"_account_id":5754,"name":"Alex Xu","email":"hejie.xu@intel.com","username":"xuhj"},"change_message_id":"419f0feae229800ffe5adfedb317cf1ea36f1b7c","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* If a call is made which attempts to put a resource into a state which it is"},{"line_number":40,"context_line":"  already in (eg locking an instance which is already locked), the return code"},{"line_number":41,"context_line":"  should be **200 OK**."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Failure Codes"},{"line_number":44,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9af37de9_62f2bb9c","line":41,"in_reply_to":"9af37de9_87fff133","updated":"2015-05-11 06:40:19.000000000","message":"Should we put some words about why not 409?","commit_id":"b2fbadad1e8ad4c58968507ce07347b90c0dfbc0"},{"author":{"_account_id":12606,"name":"Miguel Grinberg","email":"miguel.grinberg@gmail.com","username":"miguelgrinberg"},"change_message_id":"cbb74946294a5e3a65d4d603c34d86eb21ce8901","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* If a call is made which attempts to put a resource into a state which it is"},{"line_number":40,"context_line":"  already in (eg locking an instance which is already locked), the return code"},{"line_number":41,"context_line":"  should be in the **2xx Successful** range (usually matching the return code"},{"line_number":42,"context_line":"  which would be given if the state had changed). It is not appropriate to use"},{"line_number":43,"context_line":"  **409 Conflict** when the resulting state of the resource is as the user"},{"line_number":44,"context_line":"  requested."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7ad8896b_f1620216","line":41,"updated":"2015-05-11 16:49:17.000000000","message":"This is implied, but would it make sense to add a note regarding the special \"202 Accepted\" status code? That would apply to asynchronous state changes. I expect an asynchronous request should return 202 if a previous request for the same state change is in progress.","commit_id":"58c2f4697676b429872cdb2a864a1e12ad4ec2cc"},{"author":{"_account_id":9420,"name":"Matthew Gilliard","email":"matthew.gilliard@hp.com","username":"gilliard"},"change_message_id":"df77f7a45d53c811245fd520860a342373cb5f76","unresolved":false,"context_lines":[{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* If a call is made which attempts to put a resource into a state which it is"},{"line_number":40,"context_line":"  already in (eg locking an instance which is already locked), the return code"},{"line_number":41,"context_line":"  should be in the **2xx Successful** range (usually matching the return code"},{"line_number":42,"context_line":"  which would be given if the state had changed). It is not appropriate to use"},{"line_number":43,"context_line":"  **409 Conflict** when the resulting state of the resource is as the user"},{"line_number":44,"context_line":"  requested."}],"source_content_type":"text/x-rst","patch_set":2,"id":"9a0c5dc1_b0e11901","line":41,"in_reply_to":"7ad8896b_f1620216","updated":"2015-05-12 07:42:00.000000000","message":"There\u0027s a lot of different combinations possible here - I was hoping to avoid listing them all out but I\u0027ll add a couple of examples if that\u0027s helpful.","commit_id":"58c2f4697676b429872cdb2a864a1e12ad4ec2cc"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"ee2bc86d242269878eb9e3268685b5007c70a269","unresolved":false,"context_lines":[{"line_number":36,"context_line":""},{"line_number":37,"context_line":"* For all other successful calls, the return code should be **200 OK**."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* If a call is made which attempts to put a resource into a state which it is"},{"line_number":40,"context_line":"  already in (eg locking an instance which is already locked), the return code"},{"line_number":41,"context_line":"  should be in the **2xx Successful** range (usually matching the return code"},{"line_number":42,"context_line":"  which would be given if the state had changed). It is not appropriate to use"}],"source_content_type":"text/x-rst","patch_set":4,"id":"5afe65bd_eae98d1b","line":39,"updated":"2015-06-03 10:13:26.000000000","message":"If there\u0027s another patch s/call/request/\n\nthis isn\u0027t rpc","commit_id":"678fcd02d495d5db1cbd01b74f241a1394e624da"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"99d0bdc13678527a25ef28bb7c66dee26a47546f","unresolved":false,"context_lines":[{"line_number":41,"context_line":"  should be in the **2xx Successful** range (usually matching the return code"},{"line_number":42,"context_line":"  which would be given if the state had changed). It is not appropriate to use"},{"line_number":43,"context_line":"  **409 Conflict** when the resulting state of the resource is as the user"},{"line_number":44,"context_line":"  requested."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"Failure Codes"},{"line_number":47,"context_line":"~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3afb71cf_816330dc","line":44,"updated":"2015-06-08 01:19:56.000000000","message":"could mention idempotency here.","commit_id":"678fcd02d495d5db1cbd01b74f241a1394e624da"}]}