)]}'
{"guidelines/uri.rst":[{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"992929b878bd45c792f04410c946c722679fee79","unresolved":false,"context_lines":[{"line_number":145,"context_line":"URI length of about 2K, while web servers such as Apache limit URIs to around"},{"line_number":146,"context_line":"8K. If the length of the URI needed to express the complex requirements of a"},{"line_number":147,"context_line":"request may possibly exceed those limits, it is acceptable to use the ``POST``"},{"line_number":148,"context_line":"method with the filter conditions passed in the body of the request."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":".. rubric:: Footnotes"},{"line_number":151,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba5da102_d24ec495","line":148,"updated":"2016-10-26 10:18:25.000000000","message":"How will it be distinguished from POST request to create an item? E.g. what does POST /birds mean: a query or a request to create? I tend to agree with Chris that we should not recommend it.","commit_id":"5999cef8f658c0149691bb0939269b1f7651db8a"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"971d741fc12b5f801593d675549a48017d7132c2","unresolved":false,"context_lines":[{"line_number":145,"context_line":"URI length of about 2K, while web servers such as Apache limit URIs to around"},{"line_number":146,"context_line":"8K. If the length of the URI needed to express the complex requirements of a"},{"line_number":147,"context_line":"request may possibly exceed those limits, it is acceptable to use the ``POST``"},{"line_number":148,"context_line":"method with the filter conditions passed in the body of the request."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":".. rubric:: Footnotes"},{"line_number":151,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa6399be_1b909f94","line":148,"updated":"2016-10-14 13:50:52.000000000","message":"This is good, but if we wanted to be even more advisory here I think it would be fair to say something that politely says \"If your query needs to really long, you might want to think if your requesting the right thing with the right parameters.\"\n\nGenerally the only time I\u0027ve ever seen a query get huge is when you are providing a list of many of the same things for a mass action you want to have happen (for example a state change on thousands (but not all) of something in a batch). In which case POST is right.","commit_id":"5999cef8f658c0149691bb0939269b1f7651db8a"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"84bb6fe2731405646e468e9e2369f6139f70d753","unresolved":false,"context_lines":[{"line_number":145,"context_line":"URI length of about 2K, while web servers such as Apache limit URIs to around"},{"line_number":146,"context_line":"8K. If the length of the URI needed to express the complex requirements of a"},{"line_number":147,"context_line":"request may possibly exceed those limits, it is acceptable to use the ``POST``"},{"line_number":148,"context_line":"method with the filter conditions passed in the body of the request."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":".. rubric:: Footnotes"},{"line_number":151,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba5da102_f32580ae","line":148,"in_reply_to":"ba5da102_d24ec495","updated":"2016-10-26 17:46:47.000000000","message":"POST doesn\u0027t always mean \u0027create\u0027; that\u0027s why it\u0027s acceptable in some circumstances for complex queries and the like. It is up to the service receiving the POST to interpret what to do with it, based on the body or perhaps the headers.","commit_id":"5999cef8f658c0149691bb0939269b1f7651db8a"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"b2ef3454623f78867a815a40ed0ef22b8e2e6781","unresolved":false,"context_lines":[{"line_number":145,"context_line":"URI length of about 2K, while web servers such as Apache limit URIs to around"},{"line_number":146,"context_line":"8K. If the length of the URI needed to express the complex requirements of a"},{"line_number":147,"context_line":"request may possibly exceed those limits, it is acceptable to use the ``POST``"},{"line_number":148,"context_line":"method with the filter conditions passed in the body of the request."},{"line_number":149,"context_line":""},{"line_number":150,"context_line":".. rubric:: Footnotes"},{"line_number":151,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa6399be_7bbc3bbb","line":148,"in_reply_to":"fa6399be_1b909f94","updated":"2016-10-14 13:59:47.000000000","message":"OK, I hadn\u0027t thought of it from that angle.","commit_id":"5999cef8f658c0149691bb0939269b1f7651db8a"}]}