)]}'
{"openstack-identity-api/v3/src/markdown/identity-api-v3.md":[{"author":{"_account_id":220,"name":"Haneef Ali","email":"haneef.ali@hp.com","username":"haneef"},"change_message_id":"e48842ee3b78d8ba9c652b2db305b7018bbf0cbf","unresolved":false,"context_lines":[{"line_number":2231,"context_line":""},{"line_number":2232,"context_line":"    Status: 204 No Content"},{"line_number":2233,"context_line":""},{"line_number":2234,"context_line":"#### Change user password: `POST /users/{user_id}/change_password`"},{"line_number":2235,"context_line":""},{"line_number":2236,"context_line":"Request:"},{"line_number":2237,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"AAAATH%2F%2FUzQ%3D","line":2234,"updated":"2013-10-17 17:53:47.000000000","message":"Generally resource name should be \"noun\"\n\nHow about  POST/PATCH  password/\u003cuserid\u003e\n\n   or \n\nPOST/PATCH  /users/password/\u003cuser_id\u003e","commit_id":"1ffad55c305d21cf1dc15bd3755b01d4310fa987"},{"author":{"_account_id":4,"name":"Dolph Mathews","email":"dolph.mathews@gmail.com","username":"dolph"},"change_message_id":"4f5c6f7d9263a9070adbed583d05348c280d7d1c","unresolved":false,"context_lines":[{"line_number":2231,"context_line":""},{"line_number":2232,"context_line":"    Status: 204 No Content"},{"line_number":2233,"context_line":""},{"line_number":2234,"context_line":"#### Change user password: `POST /users/{user_id}/change_password`"},{"line_number":2235,"context_line":""},{"line_number":2236,"context_line":"Request:"},{"line_number":2237,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"AAAATH%2F%2FUyE%3D","line":2234,"updated":"2013-10-17 17:57:46.000000000","message":"remove the verb in the URL so it\u0027s not redundant with the HTTP verb\n\n  POST /users/{user_id}/password","commit_id":"1ffad55c305d21cf1dc15bd3755b01d4310fa987"},{"author":{"_account_id":7725,"name":"David Stanek","email":"dstanek@dstanek.com","username":"dstanek"},"change_message_id":"08e46bcb771f30c5f0c0f1d247e802eb1acb34e7","unresolved":false,"context_lines":[{"line_number":2231,"context_line":""},{"line_number":2232,"context_line":"    Status: 204 No Content"},{"line_number":2233,"context_line":""},{"line_number":2234,"context_line":"#### Change user password: `POST /users/{user_id}/change_password`"},{"line_number":2235,"context_line":""},{"line_number":2236,"context_line":"Request:"},{"line_number":2237,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"AAAATH%2F%2FM88%3D","line":2234,"in_reply_to":"AAAATH%2F%2FSUY%3D","updated":"2013-10-21 14:28:10.000000000","message":"I\u0027m going to go ahead and rename this to password so that it can move forward.  I\u0027ve started to write a blueprint to describe my view of REST.","commit_id":"1ffad55c305d21cf1dc15bd3755b01d4310fa987"},{"author":{"_account_id":7725,"name":"David Stanek","email":"dstanek@dstanek.com","username":"dstanek"},"change_message_id":"d456f0aa3819bd77c321e40f4a9c0a9b53837ba0","unresolved":false,"context_lines":[{"line_number":2231,"context_line":""},{"line_number":2232,"context_line":"    Status: 204 No Content"},{"line_number":2233,"context_line":""},{"line_number":2234,"context_line":"#### Change user password: `POST /users/{user_id}/change_password`"},{"line_number":2235,"context_line":""},{"line_number":2236,"context_line":"Request:"},{"line_number":2237,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"AAAATH%2F%2FSUY%3D","line":2234,"in_reply_to":"AAAATH%2F%2FTMo%3D","updated":"2013-10-18 12:19:40.000000000","message":"Neither POST will create anything.  Neither should return a 201 or a Location header because the are not creating a new resource then are performing and action on an existing one.\n\nI think the misconception is that POST does not mean create and the names of the URLs don\u0027t mean anything.  The meaning of a URL is wrapped in the link (either header or document) used to get there.  Now I know we don\u0027t yet follow a lot of the REST principles, but I\u0027m hoping to swing us more into that direction.","commit_id":"1ffad55c305d21cf1dc15bd3755b01d4310fa987"},{"author":{"_account_id":220,"name":"Haneef Ali","email":"haneef.ali@hp.com","username":"haneef"},"change_message_id":"61dcb19587d2d72a138d8814166e321830770942","unresolved":false,"context_lines":[{"line_number":2231,"context_line":""},{"line_number":2232,"context_line":"    Status: 204 No Content"},{"line_number":2233,"context_line":""},{"line_number":2234,"context_line":"#### Change user password: `POST /users/{user_id}/change_password`"},{"line_number":2235,"context_line":""},{"line_number":2236,"context_line":"Request:"},{"line_number":2237,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"AAAATH%2F%2FTMo%3D","line":2234,"in_reply_to":"AAAATH%2F%2FUcA%3D","updated":"2013-10-18 05:46:17.000000000","message":"If you look at earlier version of REST resource it was designed as you have mentioned which is same as\n\nMyResouce?action\u003d\u003cacition_name\u003e where action \u003d cancel/reset/change_password  \n\nConsider this\n\nPOST  /users/\u003cuser_id\u003e/chaange_password   --\u003e  Creates change_password\nPOST /users/\u003cuserid\u003e/password                    --\u003e   Creates password\n\nThe second format conveys correct meaning.","commit_id":"1ffad55c305d21cf1dc15bd3755b01d4310fa987"},{"author":{"_account_id":220,"name":"Haneef Ali","email":"haneef.ali@hp.com","username":"haneef"},"change_message_id":"ec1498b8860195b2a5a96dcf89cb45a3a6c9656a","unresolved":false,"context_lines":[{"line_number":2231,"context_line":""},{"line_number":2232,"context_line":"    Status: 204 No Content"},{"line_number":2233,"context_line":""},{"line_number":2234,"context_line":"#### Change user password: `POST /users/{user_id}/change_password`"},{"line_number":2235,"context_line":""},{"line_number":2236,"context_line":"Request:"},{"line_number":2237,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"AAAATH%2F%2FUvo%3D","line":2234,"in_reply_to":"AAAATH%2F%2FUyE%3D","updated":"2013-10-17 18:06:40.000000000","message":"+1. This is better","commit_id":"1ffad55c305d21cf1dc15bd3755b01d4310fa987"},{"author":{"_account_id":7725,"name":"David Stanek","email":"dstanek@dstanek.com","username":"dstanek"},"change_message_id":"6168bd8d28e38a5d0b12b6dded8da417594ea7ba","unresolved":false,"context_lines":[{"line_number":2231,"context_line":""},{"line_number":2232,"context_line":"    Status: 204 No Content"},{"line_number":2233,"context_line":""},{"line_number":2234,"context_line":"#### Change user password: `POST /users/{user_id}/change_password`"},{"line_number":2235,"context_line":""},{"line_number":2236,"context_line":"Request:"},{"line_number":2237,"context_line":""}],"source_content_type":"text/x-markdown","patch_set":1,"id":"AAAATH%2F%2FUcA%3D","line":2234,"in_reply_to":"AAAATH%2F%2FUyE%3D","updated":"2013-10-17 19:52:15.000000000","message":"I can do that, but I thought I\u0027d briefly explain my API design philosophy.  I think of REST API resources in three categories.  A collection (users) where things are usually created and search,  a document (user) where CRUD like operations are the primary usecase and controllers that are really procedural concepts.  Controllers are usually things like cancel, resend and change_password.  Since controllers are almost always that leaf node of the resource hierarchy I give them action names.  This way they are not to be confused with resources that have CRUD like interface.\n\nOTOH I was the API to be consistent and understandable by the other OpenStack developers and with REST the actual path doesn\u0027t matter anyway.","commit_id":"1ffad55c305d21cf1dc15bd3755b01d4310fa987"}]}
