payload: {"action":"created","comment":{"url":"https://api.github.com/repos/linkedin/rest.li/pulls/comments/270603753","pull_request_review_id":220796250,"id":270603753,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDI3MDYwMzc1Mw==","diff_hunk":"@@ -448,6 +457,66 @@ The URI templates below assume variables with types as follows:\n | ---------------------------------- | --------------------- | ------------------------- | ------ | ---------------------------- |\n | Collection, Association, ActionSet | {resource}?q={finder} | /accounts?q=keywordSearch | GET    | invokes the specified finder |\n \n+## Batch Finders\n+### Batch Finder URIs\n+The URI templates below assume variables with types as follows:\n+\n+    batch_finder : simple string identifying a batch_finder method name\n+    resource : simple string identifying a resource \n+    search_criteria : simple string identifying the criteria filter name\n+\n+| Resource                           | URI Template          | Example                   | Method | Semantics                    |\n+| ---------------------------------- | --------------------- | ------------------------- | ------ | ---------------------------- |\n+| Collection, Association            | {resource}?bq={batch_finder}&{search_criteria}=| /PhotoResource?bq=searchPhotos&photoCriteria=List((id:1, format:JPG),(id:2, format:BMP)) | GET    | invokes the specified batch_finder |\n+\n+At least, 2 query parameters will have to be set for a batch finder:\n+\n+- The \"bq\" query parameter is reserved for passing the batch finder method name\n+- A second query parameter will be used to pass a set of different search criteria. The name of this query parameter is set in the [BatchFinder method annotation](/rest.li/batch_finder_resource_method#method-annotation-and-parameters).\n+For example, with @BatchFinder(value=\"findUsers\", batchParam=\"batchCriteria\"), the batch query parameter name is \"batchCriteria\". \n+The type of this query parameter is a List.\n+\n+Different data type has different representation in Rest.li protocol 1.0 and 2.0. See more details in [Rest.li Protocol](/rest.li/spec/protocol).\n+\n+Eg.\n+In Rest.li protocol 1.0\n+\n+    curl \"http://localhost:8080/userSearchResults?bq=findUsers&batchCriteria[0].firstName=pauline&batchCriteria[0].age=12&batchCriteria[1].lastName=iglou\" --globoff\n+\n+In Rest.li protocol 2.0\n+\n+    curl --header \"X-RestLi-Protocol-Version: 2.0.0\" \"http://localhost:10546/userSearchResults?q=findUsers&batchCriteria=List((firstName:pauline, age:12),(lastName:iglou))\"\n+\n+The other query parameters will be applied as common filters across all batch requests.\n+\n+Here is an example batch request with two individual finders using the following criteria:\n+\n+- filter by first name and age\n+- filter by last name and age\n+\n+Eg.\n+\n+    curl \"http://localhost:8080/userSearchResults?bq=findUsers&batchCriteria=List((firstName:pauline),(lastName:iglou))&age=21\" -X GET","path":"protocol.md","position":173,"original_position":173,"commit_id":"9e3a85e96fe8b8d746a0ffd8e2663abf4209102d","original_commit_id":"9e3a85e96fe8b8d746a0ffd8e2663abf4209102d","user":{"login":"maximelamure","id":6774344,"node_id":"MDQ6VXNlcjY3NzQzNDQ=","avatar_url":"https://avatars1.githubusercontent.com/u/6774344?v=4","gravatar_id":"","url":"https://api.github.com/users/maximelamure","html_url":"https://github.com/maximelamure","followers_url":"https://api.github.com/users/maximelamure/followers","following_url":"https://api.github.com/users/maximelamure/following{/other_user}","gists_url":"https://api.github.com/users/maximelamure/gists{/gist_id}","starred_url":"https://api.github.com/users/maximelamure/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/maximelamure/subscriptions","organizations_url":"https://api.github.com/users/maximelamure/orgs","repos_url":"https://api.github.com/users/maximelamure/repos","events_url":"https://api.github.com/users/maximelamure/events{/privacy}","received_events_url":"https://api.github.com/users/maximelamure/received_events","type":"User","site_admin":false},"body":"Looks like we use protocol V2 here. In this case, can you add the HTTP header `--header \"X-RestLi-Protocol-Version: 2.0.0\"`? The goal is to provide a working example if they copy/paste.\r\n","created_at":"2019-03-30T00:12:04Z","updated_at":"2019-03-30T00:41:14Z","html_url":"https://github.com/linkedin/rest.li/pull/125#discussion_r270603753","pull_request_url":"https://api.github.com/repos/linkedin/rest.li/pulls/125","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/linkedin/rest.li/pulls/comments/270603753"},"html":{"href":"https://github.com/linkedin/rest.li/pull/125#discussion_r270603753"},"pull_request":{"href":"https://api.github.com/repos/linkedin/rest.li/pulls/125"}}},"pull_request":{"url":"https://api.github.com/repos/linkedin/rest.li/pulls/125","id":258820242,"node_id":"MDExOlB1bGxSZXF1ZXN0MjU4ODIwMjQy","html_url":"https://github.com/linkedin/rest.li/pull/125","diff_url":"https://github.com/linkedin/rest.li/pull/125.diff","patch_url":"https://github.com/linkedin/rest.li/pull/125.patch","issue_url":"https://api.github.com/repos/linkedin/rest.li/issues/125","number":125,"state":"open","locked":false,"title":"Add documentation for BATCH_FINDER","user":{"login":"bolobobo","id":17688550,"node_id":"MDQ6VXNlcjE3Njg4NTUw","avatar_url":"https://avatars2.githubusercontent.com/u/17688550?v=4","gravatar_id":"","url":"https://api.github.com/users/bolobobo","html_url":"https://github.com/bolobobo","followers_url":"https://api.github.com/users/bolobobo/followers","following_url":"https://api.github.com/users/bolobobo/following{/other_user}","gists_url":"https://api.github.com/users/bolobobo/gists{/gist_id}","starred_url":"https://api.github.com/users/bolobobo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bolobobo/subscriptions","organizations_url":"https://api.github.com/users/bolobobo/orgs","repos_url":"https://api.github.com/users/bolobobo/repos","events_url":"https://api.github.com/users/bolobobo/events{/privacy}","received_events_url":"https://api.github.com/users/bolobobo/received_events","type":"User","site_admin":false},"body":"* Add documentation for BATCH_FINDER\r\n* Fixed dead links, typo and errors","created_at":"2019-03-06T17:53:13Z","updated_at":"2019-03-30T00:41:14Z","closed_at":null,"merged_at":null,"merge_commit_sha":"0957ea411295a279a0770c739fbd8881fdf71c67","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/linkedin/rest.li/pulls/125/commits","review_comments_url":"https://api.github.com/repos/linkedin/rest.li/pulls/125/comments","review_comment_url":"https://api.github.com/repos/linkedin/rest.li/pulls/comments{/number}","comments_url":"https://api.github.com/repos/linkedin/rest.li/issues/125/comments","statuses_url":"https://api.github.com/repos/linkedin/rest.li/statuses/9e3a85e96fe8b8d746a0ffd8e2663abf4209102d","head":{"label":"linkedin:jguan-pages","ref":"jguan-pages","sha":"9e3a85e96fe8b8d746a0ffd8e2663abf4209102d","user":{"login":"linkedin","id":357098,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM1NzA5OA==","avatar_url":"https://avatars3.githubusercontent.com/u/357098?v=4","gravatar_id":"","url":"https://api.github.com/users/linkedin","html_url":"https://github.com/linkedin","followers_url":"https://api.github.com/users/linkedin/followers","following_url":"https://api.github.com/users/linkedin/following{/other_user}","gists_url":"https://api.github.com/users/linkedin/gists{/gist_id}","starred_url":"https://api.github.com/users/linkedin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/linkedin/subscriptions","organizations_url":"https://api.github.com/users/linkedin/orgs","repos_url":"https://api.github.com/users/linkedin/repos","events_url":"https://api.github.com/users/linkedin/events{/privacy}","received_events_url":"https://api.github.com/users/linkedin/received_events","type":"Organization","site_admin":false},"repo":{"id":6944525,"node_id":"MDEwOlJlcG9zaXRvcnk2OTQ0NTI1","name":"rest.li","full_name":"linkedin/rest.li","private":false,"owner":{"login":"linkedin","id":357098,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM1NzA5OA==","avatar_url":"https://avatars3.githubusercontent.com/u/357098?v=4","gravatar_id":"","url":"https://api.github.com/users/linkedin","html_url":"https://github.com/linkedin","followers_url":"https://api.github.com/users/linkedin/followers","following_url":"https://api.github.com/users/linkedin/following{/other_user}","gists_url":"https://api.github.com/users/linkedin/gists{/gist_id}","starred_url":"https://api.github.com/users/linkedin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/linkedin/subscriptions","organizations_url":"https://api.github.com/users/linkedin/orgs","repos_url":"https://api.github.com/users/linkedin/repos","events_url":"https://api.github.com/users/linkedin/events{/privacy}","received_events_url":"https://api.github.com/users/linkedin/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/linkedin/rest.li","description":"Rest.li is a REST+JSON framework for building robust, scalable service architectures using dynamic discovery and simple asynchronous APIs.","fork":false,"url":"https://api.github.com/repos/linkedin/rest.li","forks_url":"https://api.github.com/repos/linkedin/rest.li/forks","keys_url":"https://api.github.com/repos/linkedin/rest.li/keys{/key_id}","collaborators_url":"https://api.github.com/repos/linkedin/rest.li/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/linkedin/rest.li/teams","hooks_url":"https://api.github.com/repos/linkedin/rest.li/hooks","issue_events_url":"https://api.github.com/repos/linkedin/rest.li/issues/events{/number}","events_url":"https://api.github.com/repos/linkedin/rest.li/events","assignees_url":"https://api.github.com/repos/linkedin/rest.li/assignees{/user}","branches_url":"https://api.github.com/repos/linkedin/rest.li/branches{/branch}","tags_url":"https://api.github.com/repos/linkedin/rest.li/tags","blobs_url":"https://api.github.com/repos/linkedin/rest.li/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/linkedin/rest.li/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/linkedin/rest.li/git/refs{/sha}","trees_url":"https://api.github.com/repos/linkedin/rest.li/git/trees{/sha}","statuses_url":"https://api.github.com/repos/linkedin/rest.li/statuses/{sha}","languages_url":"https://api.github.com/repos/linkedin/rest.li/languages","stargazers_url":"https://api.github.com/repos/linkedin/rest.li/stargazers","contributors_url":"https://api.github.com/repos/linkedin/rest.li/contributors","subscribers_url":"https://api.github.com/repos/linkedin/rest.li/subscribers","subscription_url":"https://api.github.com/repos/linkedin/rest.li/subscription","commits_url":"https://api.github.com/repos/linkedin/rest.li/commits{/sha}","git_commits_url":"https://api.github.com/repos/linkedin/rest.li/git/commits{/sha}","comments_url":"https://api.github.com/repos/linkedin/rest.li/comments{/number}","issue_comment_url":"https://api.github.com/repos/linkedin/rest.li/issues/comments{/number}","contents_url":"https://api.github.com/repos/linkedin/rest.li/contents/{+path}","compare_url":"https://api.github.com/repos/linkedin/rest.li/compare/{base}...{head}","merges_url":"https://api.github.com/repos/linkedin/rest.li/merges","archive_url":"https://api.github.com/repos/linkedin/rest.li/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/linkedin/rest.li/downloads","issues_url":"https://api.github.com/repos/linkedin/rest.li/issues{/number}","pulls_url":"https://api.github.com/repos/linkedin/rest.li/pulls{/number}","milestones_url":"https://api.github.com/repos/linkedin/rest.li/milestones{/number}","notifications_url":"https://api.github.com/repos/linkedin/rest.li/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/linkedin/rest.li/labels{/name}","releases_url":"https://api.github.com/repos/linkedin/rest.li/releases{/id}","deployments_url":"https://api.github.com/repos/linkedin/rest.li/deployments","created_at":"2012-11-30T19:37:51Z","updated_at":"2019-03-28T18:24:53Z","pushed_at":"2019-03-28T18:24:38Z","git_url":"git://github.com/linkedin/rest.li.git","ssh_url":"git@github.com:linkedin/rest.li.git","clone_url":"https://github.com/linkedin/rest.li.git","svn_url":"https://github.com/linkedin/rest.li","homepage":"rest.li","size":18915,"stargazers_count":1901,"watchers_count":1901,"language":"Java","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":379,"mirror_url":null,"archived":false,"open_issues_count":25,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":379,"open_issues":25,"watchers":1901,"default_branch":"master"}},"base":{"label":"linkedin:gh-pages","ref":"gh-pages","sha":"7781c10535c4f67ce0d79341a4394caf24782756","user":{"login":"linkedin","id":357098,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM1NzA5OA==","avatar_url":"https://avatars3.githubusercontent.com/u/357098?v=4","gravatar_id":"","url":"https://api.github.com/users/linkedin","html_url":"https://github.com/linkedin","followers_url":"https://api.github.com/users/linkedin/followers","following_url":"https://api.github.com/users/linkedin/following{/other_user}","gists_url":"https://api.github.com/users/linkedin/gists{/gist_id}","starred_url":"https://api.github.com/users/linkedin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/linkedin/subscriptions","organizations_url":"https://api.github.com/users/linkedin/orgs","repos_url":"https://api.github.com/users/linkedin/repos","events_url":"https://api.github.com/users/linkedin/events{/privacy}","received_events_url":"https://api.github.com/users/linkedin/received_events","type":"Organization","site_admin":false},"repo":{"id":6944525,"node_id":"MDEwOlJlcG9zaXRvcnk2OTQ0NTI1","name":"rest.li","full_name":"linkedin/rest.li","private":false,"owner":{"login":"linkedin","id":357098,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM1NzA5OA==","avatar_url":"https://avatars3.githubusercontent.com/u/357098?v=4","gravatar_id":"","url":"https://api.github.com/users/linkedin","html_url":"https://github.com/linkedin","followers_url":"https://api.github.com/users/linkedin/followers","following_url":"https://api.github.com/users/linkedin/following{/other_user}","gists_url":"https://api.github.com/users/linkedin/gists{/gist_id}","starred_url":"https://api.github.com/users/linkedin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/linkedin/subscriptions","organizations_url":"https://api.github.com/users/linkedin/orgs","repos_url":"https://api.github.com/users/linkedin/repos","events_url":"https://api.github.com/users/linkedin/events{/privacy}","received_events_url":"https://api.github.com/users/linkedin/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/linkedin/rest.li","description":"Rest.li is a REST+JSON framework for building robust, scalable service architectures using dynamic discovery and simple asynchronous APIs.","fork":false,"url":"https://api.github.com/repos/linkedin/rest.li","forks_url":"https://api.github.com/repos/linkedin/rest.li/forks","keys_url":"https://api.github.com/repos/linkedin/rest.li/keys{/key_id}","collaborators_url":"https://api.github.com/repos/linkedin/rest.li/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/linkedin/rest.li/teams","hooks_url":"https://api.github.com/repos/linkedin/rest.li/hooks","issue_events_url":"https://api.github.com/repos/linkedin/rest.li/issues/events{/number}","events_url":"https://api.github.com/repos/linkedin/rest.li/events","assignees_url":"https://api.github.com/repos/linkedin/rest.li/assignees{/user}","branches_url":"https://api.github.com/repos/linkedin/rest.li/branches{/branch}","tags_url":"https://api.github.com/repos/linkedin/rest.li/tags","blobs_url":"https://api.github.com/repos/linkedin/rest.li/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/linkedin/rest.li/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/linkedin/rest.li/git/refs{/sha}","trees_url":"https://api.github.com/repos/linkedin/rest.li/git/trees{/sha}","statuses_url":"https://api.github.com/repos/linkedin/rest.li/statuses/{sha}","languages_url":"https://api.github.com/repos/linkedin/rest.li/languages","stargazers_url":"https://api.github.com/repos/linkedin/rest.li/stargazers","contributors_url":"https://api.github.com/repos/linkedin/rest.li/contributors","subscribers_url":"https://api.github.com/repos/linkedin/rest.li/subscribers","subscription_url":"https://api.github.com/repos/linkedin/rest.li/subscription","commits_url":"https://api.github.com/repos/linkedin/rest.li/commits{/sha}","git_commits_url":"https://api.github.com/repos/linkedin/rest.li/git/commits{/sha}","comments_url":"https://api.github.com/repos/linkedin/rest.li/comments{/number}","issue_comment_url":"https://api.github.com/repos/linkedin/rest.li/issues/comments{/number}","contents_url":"https://api.github.com/repos/linkedin/rest.li/contents/{+path}","compare_url":"https://api.github.com/repos/linkedin/rest.li/compare/{base}...{head}","merges_url":"https://api.github.com/repos/linkedin/rest.li/merges","archive_url":"https://api.github.com/repos/linkedin/rest.li/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/linkedin/rest.li/downloads","issues_url":"https://api.github.com/repos/linkedin/rest.li/issues{/number}","pulls_url":"https://api.github.com/repos/linkedin/rest.li/pulls{/number}","milestones_url":"https://api.github.com/repos/linkedin/rest.li/milestones{/number}","notifications_url":"https://api.github.com/repos/linkedin/rest.li/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/linkedin/rest.li/labels{/name}","releases_url":"https://api.github.com/repos/linkedin/rest.li/releases{/id}","deployments_url":"https://api.github.com/repos/linkedin/rest.li/deployments","created_at":"2012-11-30T19:37:51Z","updated_at":"2019-03-28T18:24:53Z","pushed_at":"2019-03-28T18:24:38Z","git_url":"git://github.com/linkedin/rest.li.git","ssh_url":"git@github.com:linkedin/rest.li.git","clone_url":"https://github.com/linkedin/rest.li.git","svn_url":"https://github.com/linkedin/rest.li","homepage":"rest.li","size":18915,"stargazers_count":1901,"watchers_count":1901,"language":"Java","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":379,"mirror_url":null,"archived":false,"open_issues_count":25,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":379,"open_issues":25,"watchers":1901,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/linkedin/rest.li/pulls/125"},"html":{"href":"https://github.com/linkedin/rest.li/pull/125"},"issue":{"href":"https://api.github.com/repos/linkedin/rest.li/issues/125"},"comments":{"href":"https://api.github.com/repos/linkedin/rest.li/issues/125/comments"},"review_comments":{"href":"https://api.github.com/repos/linkedin/rest.li/pulls/125/comments"},"review_comment":{"href":"https://api.github.com/repos/linkedin/rest.li/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/linkedin/rest.li/pulls/125/commits"},"statuses":{"href":"https://api.github.com/repos/linkedin/rest.li/statuses/9e3a85e96fe8b8d746a0ffd8e2663abf4209102d"}},"author_association":"CONTRIBUTOR"}}
other: {"actor":{"display_login":"maximelamure"}}