{"action":"created","comment":{"url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/comments/35645290","id":35645290,"diff_hunk":"@@ -478,6 +490,232 @@ Name and description of the API\n \n ---\n \n+<a name=\"def-authentication-section\"></a>\n+## Authentication section\n+- **Parent sections:** none\n+- **Nested sections:** [`1` Authentication schemes section](#def-authenticationschemes-section), [`1` Response section](#def-response-section)\n+- **Markdown entity:** header\n+- **Inherits from**: none\n+\n+#### Definition\n+Defined by the `Authentication` keyword in Markdown header entity.\n+\n+    # Authentication","path":"API Blueprint Specification.md","position":67,"original_position":67,"commit_id":"6f919f80c82ccbf35a1e9d446bf850e15f65b5af","original_commit_id":"6f919f80c82ccbf35a1e9d446bf850e15f65b5af","user":{"login":"kylef","id":44164,"avatar_url":"https://avatars.githubusercontent.com/u/44164?v=3","gravatar_id":"","url":"https://api.github.com/users/kylef","html_url":"https://github.com/kylef","followers_url":"https://api.github.com/users/kylef/followers","following_url":"https://api.github.com/users/kylef/following{/other_user}","gists_url":"https://api.github.com/users/kylef/gists{/gist_id}","starred_url":"https://api.github.com/users/kylef/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kylef/subscriptions","organizations_url":"https://api.github.com/users/kylef/orgs","repos_url":"https://api.github.com/users/kylef/repos","events_url":"https://api.github.com/users/kylef/events{/privacy}","received_events_url":"https://api.github.com/users/kylef/received_events","type":"User","site_admin":false},"body":"There should never be a case where this is level 1 heading and instead should be 2 (`##`) since it should sit within the API ([API Name section](https://github.com/apiaryio/api-blueprint/blob/master/API%20Blueprint%20Specification.md#api-name--overview-section)).","created_at":"2015-07-28T13:19:58Z","updated_at":"2015-07-28T13:19:58Z","html_url":"https://github.com/apiaryio/api-blueprint/pull/201#discussion_r35645290","pull_request_url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201","_links":{"self":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/comments/35645290"},"html":{"href":"https://github.com/apiaryio/api-blueprint/pull/201#discussion_r35645290"},"pull_request":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201"}}},"pull_request":{"url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201","id":36629167,"html_url":"https://github.com/apiaryio/api-blueprint/pull/201","diff_url":"https://github.com/apiaryio/api-blueprint/pull/201.diff","patch_url":"https://github.com/apiaryio/api-blueprint/pull/201.patch","issue_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues/201","number":201,"state":"open","locked":false,"title":"Authentication syntax proposal","user":{"login":"pksunkara","id":174703,"avatar_url":"https://avatars.githubusercontent.com/u/174703?v=3","gravatar_id":"","url":"https://api.github.com/users/pksunkara","html_url":"https://github.com/pksunkara","followers_url":"https://api.github.com/users/pksunkara/followers","following_url":"https://api.github.com/users/pksunkara/following{/other_user}","gists_url":"https://api.github.com/users/pksunkara/gists{/gist_id}","starred_url":"https://api.github.com/users/pksunkara/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pksunkara/subscriptions","organizations_url":"https://api.github.com/users/pksunkara/orgs","repos_url":"https://api.github.com/users/pksunkara/repos","events_url":"https://api.github.com/users/pksunkara/events{/privacy}","received_events_url":"https://api.github.com/users/pksunkara/received_events","type":"User","site_admin":false},"body":"This PR includes syntax proposal for Authentication support (#11) in API Blueprint. The syntax adds an `Authentication` section and an `Authentication Schemes` section to the blueprint using which the writer can define the authentication schemes supported by their API and which endpoints need which kind of authentication.\r\n\r\nFor now, an user can select authentication schemes from a list of schemes which are inherently supported by the API Blueprint. They are:\r\n\r\n* Basic Authentication Scheme\r\n* Oauth 2.0 Authentication Scheme\r\n* Bearer Authentication Scheme\r\n\r\nFor more information, read the spec and the Authentication example in `examples` folder.","created_at":"2015-06-01T13:37:58Z","updated_at":"2015-07-28T13:19:58Z","closed_at":null,"merged_at":null,"merge_commit_sha":"6c27f72c5cbd53d9388fd362c1a0d8eef9a7ff69","assignee":{"login":"zdne","id":613617,"avatar_url":"https://avatars.githubusercontent.com/u/613617?v=3","gravatar_id":"","url":"https://api.github.com/users/zdne","html_url":"https://github.com/zdne","followers_url":"https://api.github.com/users/zdne/followers","following_url":"https://api.github.com/users/zdne/following{/other_user}","gists_url":"https://api.github.com/users/zdne/gists{/gist_id}","starred_url":"https://api.github.com/users/zdne/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zdne/subscriptions","organizations_url":"https://api.github.com/users/zdne/orgs","repos_url":"https://api.github.com/users/zdne/repos","events_url":"https://api.github.com/users/zdne/events{/privacy}","received_events_url":"https://api.github.com/users/zdne/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201/commits","review_comments_url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201/comments","review_comment_url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/comments{/number}","comments_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues/201/comments","statuses_url":"https://api.github.com/repos/apiaryio/api-blueprint/statuses/6f919f80c82ccbf35a1e9d446bf850e15f65b5af","head":{"label":"apiaryio:pksunkara/auth","ref":"pksunkara/auth","sha":"6f919f80c82ccbf35a1e9d446bf850e15f65b5af","user":{"login":"apiaryio","id":765943,"avatar_url":"https://avatars.githubusercontent.com/u/765943?v=3","gravatar_id":"","url":"https://api.github.com/users/apiaryio","html_url":"https://github.com/apiaryio","followers_url":"https://api.github.com/users/apiaryio/followers","following_url":"https://api.github.com/users/apiaryio/following{/other_user}","gists_url":"https://api.github.com/users/apiaryio/gists{/gist_id}","starred_url":"https://api.github.com/users/apiaryio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apiaryio/subscriptions","organizations_url":"https://api.github.com/users/apiaryio/orgs","repos_url":"https://api.github.com/users/apiaryio/repos","events_url":"https://api.github.com/users/apiaryio/events{/privacy}","received_events_url":"https://api.github.com/users/apiaryio/received_events","type":"Organization","site_admin":false},"repo":{"id":9711133,"name":"api-blueprint","full_name":"apiaryio/api-blueprint","owner":{"login":"apiaryio","id":765943,"avatar_url":"https://avatars.githubusercontent.com/u/765943?v=3","gravatar_id":"","url":"https://api.github.com/users/apiaryio","html_url":"https://github.com/apiaryio","followers_url":"https://api.github.com/users/apiaryio/followers","following_url":"https://api.github.com/users/apiaryio/following{/other_user}","gists_url":"https://api.github.com/users/apiaryio/gists{/gist_id}","starred_url":"https://api.github.com/users/apiaryio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apiaryio/subscriptions","organizations_url":"https://api.github.com/users/apiaryio/orgs","repos_url":"https://api.github.com/users/apiaryio/repos","events_url":"https://api.github.com/users/apiaryio/events{/privacy}","received_events_url":"https://api.github.com/users/apiaryio/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/apiaryio/api-blueprint","description":"API Blueprint","fork":false,"url":"https://api.github.com/repos/apiaryio/api-blueprint","forks_url":"https://api.github.com/repos/apiaryio/api-blueprint/forks","keys_url":"https://api.github.com/repos/apiaryio/api-blueprint/keys{/key_id}","collaborators_url":"https://api.github.com/repos/apiaryio/api-blueprint/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/apiaryio/api-blueprint/teams","hooks_url":"https://api.github.com/repos/apiaryio/api-blueprint/hooks","issue_events_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues/events{/number}","events_url":"https://api.github.com/repos/apiaryio/api-blueprint/events","assignees_url":"https://api.github.com/repos/apiaryio/api-blueprint/assignees{/user}","branches_url":"https://api.github.com/repos/apiaryio/api-blueprint/branches{/branch}","tags_url":"https://api.github.com/repos/apiaryio/api-blueprint/tags","blobs_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/refs{/sha}","trees_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/trees{/sha}","statuses_url":"https://api.github.com/repos/apiaryio/api-blueprint/statuses/{sha}","languages_url":"https://api.github.com/repos/apiaryio/api-blueprint/languages","stargazers_url":"https://api.github.com/repos/apiaryio/api-blueprint/stargazers","contributors_url":"https://api.github.com/repos/apiaryio/api-blueprint/contributors","subscribers_url":"https://api.github.com/repos/apiaryio/api-blueprint/subscribers","subscription_url":"https://api.github.com/repos/apiaryio/api-blueprint/subscription","commits_url":"https://api.github.com/repos/apiaryio/api-blueprint/commits{/sha}","git_commits_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/commits{/sha}","comments_url":"https://api.github.com/repos/apiaryio/api-blueprint/comments{/number}","issue_comment_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues/comments{/number}","contents_url":"https://api.github.com/repos/apiaryio/api-blueprint/contents/{+path}","compare_url":"https://api.github.com/repos/apiaryio/api-blueprint/compare/{base}...{head}","merges_url":"https://api.github.com/repos/apiaryio/api-blueprint/merges","archive_url":"https://api.github.com/repos/apiaryio/api-blueprint/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/apiaryio/api-blueprint/downloads","issues_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues{/number}","pulls_url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls{/number}","milestones_url":"https://api.github.com/repos/apiaryio/api-blueprint/milestones{/number}","notifications_url":"https://api.github.com/repos/apiaryio/api-blueprint/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/apiaryio/api-blueprint/labels{/name}","releases_url":"https://api.github.com/repos/apiaryio/api-blueprint/releases{/id}","created_at":"2013-04-27T07:34:33Z","updated_at":"2015-07-28T06:39:48Z","pushed_at":"2015-07-27T21:49:38Z","git_url":"git://github.com/apiaryio/api-blueprint.git","ssh_url":"git@github.com:apiaryio/api-blueprint.git","clone_url":"https://github.com/apiaryio/api-blueprint.git","svn_url":"https://github.com/apiaryio/api-blueprint","homepage":"http://apiblueprint.org","size":6664,"stargazers_count":2440,"watchers_count":2440,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":717,"mirror_url":null,"open_issues_count":43,"forks":717,"open_issues":43,"watchers":2440,"default_branch":"master"}},"base":{"label":"apiaryio:master","ref":"master","sha":"c9e609939e69bae0a7ca5e9cf3bbd9ba867c3231","user":{"login":"apiaryio","id":765943,"avatar_url":"https://avatars.githubusercontent.com/u/765943?v=3","gravatar_id":"","url":"https://api.github.com/users/apiaryio","html_url":"https://github.com/apiaryio","followers_url":"https://api.github.com/users/apiaryio/followers","following_url":"https://api.github.com/users/apiaryio/following{/other_user}","gists_url":"https://api.github.com/users/apiaryio/gists{/gist_id}","starred_url":"https://api.github.com/users/apiaryio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apiaryio/subscriptions","organizations_url":"https://api.github.com/users/apiaryio/orgs","repos_url":"https://api.github.com/users/apiaryio/repos","events_url":"https://api.github.com/users/apiaryio/events{/privacy}","received_events_url":"https://api.github.com/users/apiaryio/received_events","type":"Organization","site_admin":false},"repo":{"id":9711133,"name":"api-blueprint","full_name":"apiaryio/api-blueprint","owner":{"login":"apiaryio","id":765943,"avatar_url":"https://avatars.githubusercontent.com/u/765943?v=3","gravatar_id":"","url":"https://api.github.com/users/apiaryio","html_url":"https://github.com/apiaryio","followers_url":"https://api.github.com/users/apiaryio/followers","following_url":"https://api.github.com/users/apiaryio/following{/other_user}","gists_url":"https://api.github.com/users/apiaryio/gists{/gist_id}","starred_url":"https://api.github.com/users/apiaryio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apiaryio/subscriptions","organizations_url":"https://api.github.com/users/apiaryio/orgs","repos_url":"https://api.github.com/users/apiaryio/repos","events_url":"https://api.github.com/users/apiaryio/events{/privacy}","received_events_url":"https://api.github.com/users/apiaryio/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/apiaryio/api-blueprint","description":"API Blueprint","fork":false,"url":"https://api.github.com/repos/apiaryio/api-blueprint","forks_url":"https://api.github.com/repos/apiaryio/api-blueprint/forks","keys_url":"https://api.github.com/repos/apiaryio/api-blueprint/keys{/key_id}","collaborators_url":"https://api.github.com/repos/apiaryio/api-blueprint/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/apiaryio/api-blueprint/teams","hooks_url":"https://api.github.com/repos/apiaryio/api-blueprint/hooks","issue_events_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues/events{/number}","events_url":"https://api.github.com/repos/apiaryio/api-blueprint/events","assignees_url":"https://api.github.com/repos/apiaryio/api-blueprint/assignees{/user}","branches_url":"https://api.github.com/repos/apiaryio/api-blueprint/branches{/branch}","tags_url":"https://api.github.com/repos/apiaryio/api-blueprint/tags","blobs_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/refs{/sha}","trees_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/trees{/sha}","statuses_url":"https://api.github.com/repos/apiaryio/api-blueprint/statuses/{sha}","languages_url":"https://api.github.com/repos/apiaryio/api-blueprint/languages","stargazers_url":"https://api.github.com/repos/apiaryio/api-blueprint/stargazers","contributors_url":"https://api.github.com/repos/apiaryio/api-blueprint/contributors","subscribers_url":"https://api.github.com/repos/apiaryio/api-blueprint/subscribers","subscription_url":"https://api.github.com/repos/apiaryio/api-blueprint/subscription","commits_url":"https://api.github.com/repos/apiaryio/api-blueprint/commits{/sha}","git_commits_url":"https://api.github.com/repos/apiaryio/api-blueprint/git/commits{/sha}","comments_url":"https://api.github.com/repos/apiaryio/api-blueprint/comments{/number}","issue_comment_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues/comments{/number}","contents_url":"https://api.github.com/repos/apiaryio/api-blueprint/contents/{+path}","compare_url":"https://api.github.com/repos/apiaryio/api-blueprint/compare/{base}...{head}","merges_url":"https://api.github.com/repos/apiaryio/api-blueprint/merges","archive_url":"https://api.github.com/repos/apiaryio/api-blueprint/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/apiaryio/api-blueprint/downloads","issues_url":"https://api.github.com/repos/apiaryio/api-blueprint/issues{/number}","pulls_url":"https://api.github.com/repos/apiaryio/api-blueprint/pulls{/number}","milestones_url":"https://api.github.com/repos/apiaryio/api-blueprint/milestones{/number}","notifications_url":"https://api.github.com/repos/apiaryio/api-blueprint/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/apiaryio/api-blueprint/labels{/name}","releases_url":"https://api.github.com/repos/apiaryio/api-blueprint/releases{/id}","created_at":"2013-04-27T07:34:33Z","updated_at":"2015-07-28T06:39:48Z","pushed_at":"2015-07-27T21:49:38Z","git_url":"git://github.com/apiaryio/api-blueprint.git","ssh_url":"git@github.com:apiaryio/api-blueprint.git","clone_url":"https://github.com/apiaryio/api-blueprint.git","svn_url":"https://github.com/apiaryio/api-blueprint","homepage":"http://apiblueprint.org","size":6664,"stargazers_count":2440,"watchers_count":2440,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":717,"mirror_url":null,"open_issues_count":43,"forks":717,"open_issues":43,"watchers":2440,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201"},"html":{"href":"https://github.com/apiaryio/api-blueprint/pull/201"},"issue":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/issues/201"},"comments":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/issues/201/comments"},"review_comments":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201/comments"},"review_comment":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/pulls/201/commits"},"statuses":{"href":"https://api.github.com/repos/apiaryio/api-blueprint/statuses/6f919f80c82ccbf35a1e9d446bf850e15f65b5af"}}}}