{"action":"created","comment":{"url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments/76811234","id":76811234,"diff_hunk":"@@ -6,65 +6,115 @@ Be compliant with the standardized HTTP method semantics summarized as follows:\n \n ### GET\n \n-- reads a resource or set of resource instances, respectively\n-- individual resources will usually generate a 404 if the resource does not exist;\n-  collection resources may return either 200 or 404 if the listing is empty\n-- must NOT have request body payload\n+GET requests are used to read a single resource or query set of resources.\n+\n+- GET requests for individual resources will usually generate a 404 if the resource does not exist\n+- GET requests for collection resources may return either 200 or 404 if the listing is empty\n+- GET requests must NOT have request body payload\n+\n+**Note:** GET requests on collection resources should provide a sufficient filter mechanism as well\n+as pagination.","path":"http/Http.md","position":15,"original_position":15,"commit_id":"709da63156c713fde8d6bd2b9d4f655a0d98cca4","original_commit_id":"709da63156c713fde8d6bd2b9d4f655a0d98cca4","user":{"login":"ePaul","id":645859,"avatar_url":"https://avatars.githubusercontent.com/u/645859?v=3","gravatar_id":"","url":"https://api.github.com/users/ePaul","html_url":"https://github.com/ePaul","followers_url":"https://api.github.com/users/ePaul/followers","following_url":"https://api.github.com/users/ePaul/following{/other_user}","gists_url":"https://api.github.com/users/ePaul/gists{/gist_id}","starred_url":"https://api.github.com/users/ePaul/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ePaul/subscriptions","organizations_url":"https://api.github.com/users/ePaul/orgs","repos_url":"https://api.github.com/users/ePaul/repos","events_url":"https://api.github.com/users/ePaul/events{/privacy}","received_events_url":"https://api.github.com/users/ePaul/received_events","type":"User","site_admin":false},"body":"Add a link to the pagination section here?","created_at":"2016-08-30T14:52:46Z","updated_at":"2016-08-30T14:52:47Z","html_url":"https://github.com/zalando/restful-api-guidelines/pull/131#discussion_r76811234","pull_request_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131","_links":{"self":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments/76811234"},"html":{"href":"https://github.com/zalando/restful-api-guidelines/pull/131#discussion_r76811234"},"pull_request":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131"}}},"pull_request":{"url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131","id":83248743,"html_url":"https://github.com/zalando/restful-api-guidelines/pull/131","diff_url":"https://github.com/zalando/restful-api-guidelines/pull/131.diff","patch_url":"https://github.com/zalando/restful-api-guidelines/pull/131.patch","issue_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/131","number":131,"state":"open","locked":false,"title":"Reformulated http methods to better expose differences between put and post","user":{"login":"tkrop","id":18184975,"avatar_url":"https://avatars.githubusercontent.com/u/18184975?v=3","gravatar_id":"","url":"https://api.github.com/users/tkrop","html_url":"https://github.com/tkrop","followers_url":"https://api.github.com/users/tkrop/followers","following_url":"https://api.github.com/users/tkrop/following{/other_user}","gists_url":"https://api.github.com/users/tkrop/gists{/gist_id}","starred_url":"https://api.github.com/users/tkrop/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tkrop/subscriptions","organizations_url":"https://api.github.com/users/tkrop/orgs","repos_url":"https://api.github.com/users/tkrop/repos","events_url":"https://api.github.com/users/tkrop/events{/privacy}","received_events_url":"https://api.github.com/users/tkrop/received_events","type":"User","site_admin":false},"body":"Fixes #88.\r\n\r\nIn this first approach, I have extended the description of the different aspects of PUT&POST, but although the other methods without directly referring to other methods. Please check whether this approach is sufficient. Please have a look on my Easter eggs, too ;).","created_at":"2016-08-30T10:49:52Z","updated_at":"2016-08-30T14:52:47Z","closed_at":null,"merged_at":null,"merge_commit_sha":"d3c23a4053a645fb3738eb4667db0b719d779850","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131/commits","review_comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131/comments","review_comment_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments{/number}","comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/131/comments","statuses_url":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/709da63156c713fde8d6bd2b9d4f655a0d98cca4","head":{"label":"zalando:improve/explain-diffs-put-and-post","ref":"improve/explain-diffs-put-and-post","sha":"709da63156c713fde8d6bd2b9d4f655a0d98cca4","user":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"repo":{"id":55240856,"name":"restful-api-guidelines","full_name":"zalando/restful-api-guidelines","owner":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/zalando/restful-api-guidelines","description":"A model set of guidelines for RESTful APIs, created by Zalando","fork":false,"url":"https://api.github.com/repos/zalando/restful-api-guidelines","forks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/forks","keys_url":"https://api.github.com/repos/zalando/restful-api-guidelines/keys{/key_id}","collaborators_url":"https://api.github.com/repos/zalando/restful-api-guidelines/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/zalando/restful-api-guidelines/teams","hooks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/hooks","issue_events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/events{/number}","events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/events","assignees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/assignees{/user}","branches_url":"https://api.github.com/repos/zalando/restful-api-guidelines/branches{/branch}","tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/tags","blobs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/refs{/sha}","trees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/trees{/sha}","statuses_url":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/{sha}","languages_url":"https://api.github.com/repos/zalando/restful-api-guidelines/languages","stargazers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/stargazers","contributors_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contributors","subscribers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscribers","subscription_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscription","commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/commits{/sha}","git_commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/commits{/sha}","comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/comments{/number}","issue_comment_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/comments{/number}","contents_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contents/{+path}","compare_url":"https://api.github.com/repos/zalando/restful-api-guidelines/compare/{base}...{head}","merges_url":"https://api.github.com/repos/zalando/restful-api-guidelines/merges","archive_url":"https://api.github.com/repos/zalando/restful-api-guidelines/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/zalando/restful-api-guidelines/downloads","issues_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues{/number}","pulls_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls{/number}","milestones_url":"https://api.github.com/repos/zalando/restful-api-guidelines/milestones{/number}","notifications_url":"https://api.github.com/repos/zalando/restful-api-guidelines/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/zalando/restful-api-guidelines/labels{/name}","releases_url":"https://api.github.com/repos/zalando/restful-api-guidelines/releases{/id}","deployments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/deployments","created_at":"2016-04-01T15:06:54Z","updated_at":"2016-08-30T02:24:57Z","pushed_at":"2016-08-30T14:16:18Z","git_url":"git://github.com/zalando/restful-api-guidelines.git","ssh_url":"git@github.com:zalando/restful-api-guidelines.git","clone_url":"https://github.com/zalando/restful-api-guidelines.git","svn_url":"https://github.com/zalando/restful-api-guidelines","homepage":"http://zalando.github.io/restful-api-guidelines/","size":6711,"stargazers_count":128,"watchers_count":128,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":22,"mirror_url":null,"open_issues_count":21,"forks":22,"open_issues":21,"watchers":128,"default_branch":"master"}},"base":{"label":"zalando:master","ref":"master","sha":"4a5c0c4b3faf664e5b6220d8a1157c22faa73eea","user":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"repo":{"id":55240856,"name":"restful-api-guidelines","full_name":"zalando/restful-api-guidelines","owner":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/zalando/restful-api-guidelines","description":"A model set of guidelines for RESTful APIs, created by Zalando","fork":false,"url":"https://api.github.com/repos/zalando/restful-api-guidelines","forks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/forks","keys_url":"https://api.github.com/repos/zalando/restful-api-guidelines/keys{/key_id}","collaborators_url":"https://api.github.com/repos/zalando/restful-api-guidelines/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/zalando/restful-api-guidelines/teams","hooks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/hooks","issue_events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/events{/number}","events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/events","assignees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/assignees{/user}","branches_url":"https://api.github.com/repos/zalando/restful-api-guidelines/branches{/branch}","tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/tags","blobs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/refs{/sha}","trees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/trees{/sha}","statuses_url":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/{sha}","languages_url":"https://api.github.com/repos/zalando/restful-api-guidelines/languages","stargazers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/stargazers","contributors_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contributors","subscribers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscribers","subscription_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscription","commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/commits{/sha}","git_commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/commits{/sha}","comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/comments{/number}","issue_comment_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/comments{/number}","contents_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contents/{+path}","compare_url":"https://api.github.com/repos/zalando/restful-api-guidelines/compare/{base}...{head}","merges_url":"https://api.github.com/repos/zalando/restful-api-guidelines/merges","archive_url":"https://api.github.com/repos/zalando/restful-api-guidelines/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/zalando/restful-api-guidelines/downloads","issues_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues{/number}","pulls_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls{/number}","milestones_url":"https://api.github.com/repos/zalando/restful-api-guidelines/milestones{/number}","notifications_url":"https://api.github.com/repos/zalando/restful-api-guidelines/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/zalando/restful-api-guidelines/labels{/name}","releases_url":"https://api.github.com/repos/zalando/restful-api-guidelines/releases{/id}","deployments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/deployments","created_at":"2016-04-01T15:06:54Z","updated_at":"2016-08-30T02:24:57Z","pushed_at":"2016-08-30T14:16:18Z","git_url":"git://github.com/zalando/restful-api-guidelines.git","ssh_url":"git@github.com:zalando/restful-api-guidelines.git","clone_url":"https://github.com/zalando/restful-api-guidelines.git","svn_url":"https://github.com/zalando/restful-api-guidelines","homepage":"http://zalando.github.io/restful-api-guidelines/","size":6711,"stargazers_count":128,"watchers_count":128,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":22,"mirror_url":null,"open_issues_count":21,"forks":22,"open_issues":21,"watchers":128,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131"},"html":{"href":"https://github.com/zalando/restful-api-guidelines/pull/131"},"issue":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/131"},"comments":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/131/comments"},"review_comments":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131/comments"},"review_comment":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/131/commits"},"statuses":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/709da63156c713fde8d6bd2b9d4f655a0d98cca4"}}}}
{"actor":{"display_login":"ePaul"}}