{"action":"created","comment":{"url":"https://api.github.com/repos/mozilla-services/syncto/pulls/comments/41408268","id":41408268,"diff_hunk":"@@ -1,28 +1,275 @@\n+.. _resource-endpoints:\n+\n ##################\n Resource endpoints\n ##################\n \n-.. _resource-endpoints:\n+GET /buckets/syncto/collections/{collection}/records\n+====================================================\n \n-In this section, the request example provided are performed using\n-`httpie <https://github.com/jkbr/httpie>`_ .\n+**Requires authentication**\n \n+Returns all records of the current user for this collection.\n \n-GET /history\n-============\n+Collection can be one of the\n+`Firefox Sync collections <https://docs.services.mozilla.com/storage/apis-1.5.html#collections>`_:\n \n-**Requires authentication**\n+The default collections used by Firefox to store sync data are:\n+\n+ - bookmarks\n+ - history\n+ - forms\n+ - prefs\n+ - tabs\n+ - password\n \n-Returns all records of the current user for this resource.\n+The following additional collections are used for internal management\n+purposes by the storage client:\n+\n+ - clients\n+ - crypto\n+ - keys\n+ - meta\n \n The returned value is a JSON mapping containing:\n \n-- ``items``: the list of records, with exhaustive attributes\n+- ``data``: the list of records, with exhaustive fields;\n+\n+A ``Total-Records`` response header indicates the total number of records\n+of the collection.\n+\n+A ``Last-Modified`` response header provides a human-readable (rounded to second)\n+of the current collection timestamp.\n+\n+For cache and concurrency control, an ``ETag`` response header gives the\n+value that consumers can provide in subsequent requests using ``If-Match``\n+and ``If-None-Match`` headers (see :ref:`section about timestamps <server-timestamps>`).\n+\n+**Request**:\n+\n+.. code-block:: http","path":"docs/api/resource.rst","position":58,"original_position":58,"commit_id":"a4d63a04e728020c14be62c5eea480fd769568c0","original_commit_id":"a4d63a04e728020c14be62c5eea480fd769568c0","user":{"login":"ametaireau","id":67073,"avatar_url":"https://avatars.githubusercontent.com/u/67073?v=3","gravatar_id":"","url":"https://api.github.com/users/ametaireau","html_url":"https://github.com/ametaireau","followers_url":"https://api.github.com/users/ametaireau/followers","following_url":"https://api.github.com/users/ametaireau/following{/other_user}","gists_url":"https://api.github.com/users/ametaireau/gists{/gist_id}","starred_url":"https://api.github.com/users/ametaireau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ametaireau/subscriptions","organizations_url":"https://api.github.com/users/ametaireau/orgs","repos_url":"https://api.github.com/users/ametaireau/repos","events_url":"https://api.github.com/users/ametaireau/events{/privacy}","received_events_url":"https://api.github.com/users/ametaireau/received_events","type":"User","site_admin":false},"body":"Use httpie and separate request and response bodies;","created_at":"2015-10-07T15:55:31Z","updated_at":"2015-10-07T15:55:31Z","html_url":"https://github.com/mozilla-services/syncto/pull/20#discussion_r41408268","pull_request_url":"https://api.github.com/repos/mozilla-services/syncto/pulls/20","_links":{"self":{"href":"https://api.github.com/repos/mozilla-services/syncto/pulls/comments/41408268"},"html":{"href":"https://github.com/mozilla-services/syncto/pull/20#discussion_r41408268"},"pull_request":{"href":"https://api.github.com/repos/mozilla-services/syncto/pulls/20"}}},"pull_request":{"url":"https://api.github.com/repos/mozilla-services/syncto/pulls/20","id":46912895,"html_url":"https://github.com/mozilla-services/syncto/pull/20","diff_url":"https://github.com/mozilla-services/syncto/pull/20.diff","patch_url":"https://github.com/mozilla-services/syncto/pull/20.patch","issue_url":"https://api.github.com/repos/mozilla-services/syncto/issues/20","number":20,"state":"open","locked":false,"title":"Plug Syncto with Cliquet docs.","user":{"login":"Natim","id":229453,"avatar_url":"https://avatars.githubusercontent.com/u/229453?v=3","gravatar_id":"","url":"https://api.github.com/users/Natim","html_url":"https://github.com/Natim","followers_url":"https://api.github.com/users/Natim/followers","following_url":"https://api.github.com/users/Natim/following{/other_user}","gists_url":"https://api.github.com/users/Natim/gists{/gist_id}","starred_url":"https://api.github.com/users/Natim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Natim/subscriptions","organizations_url":"https://api.github.com/users/Natim/orgs","repos_url":"https://api.github.com/users/Natim/repos","events_url":"https://api.github.com/users/Natim/events{/privacy}","received_events_url":"https://api.github.com/users/Natim/received_events","type":"User","site_admin":false},"body":"Kinto is nicely plugged with Cliquet docs, we should do the same with Syncto.","created_at":"2015-10-06T14:50:22Z","updated_at":"2015-10-07T15:55:31Z","closed_at":null,"merged_at":null,"merge_commit_sha":"3c8ad11f760d1c26fb7d3eacaf4ab7492afe19bb","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/mozilla-services/syncto/pulls/20/commits","review_comments_url":"https://api.github.com/repos/mozilla-services/syncto/pulls/20/comments","review_comment_url":"https://api.github.com/repos/mozilla-services/syncto/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mozilla-services/syncto/issues/20/comments","statuses_url":"https://api.github.com/repos/mozilla-services/syncto/statuses/a4d63a04e728020c14be62c5eea480fd769568c0","head":{"label":"mozilla-services:documentation","ref":"documentation","sha":"a4d63a04e728020c14be62c5eea480fd769568c0","user":{"login":"mozilla-services","id":1066228,"avatar_url":"https://avatars.githubusercontent.com/u/1066228?v=3","gravatar_id":"","url":"https://api.github.com/users/mozilla-services","html_url":"https://github.com/mozilla-services","followers_url":"https://api.github.com/users/mozilla-services/followers","following_url":"https://api.github.com/users/mozilla-services/following{/other_user}","gists_url":"https://api.github.com/users/mozilla-services/gists{/gist_id}","starred_url":"https://api.github.com/users/mozilla-services/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mozilla-services/subscriptions","organizations_url":"https://api.github.com/users/mozilla-services/orgs","repos_url":"https://api.github.com/users/mozilla-services/repos","events_url":"https://api.github.com/users/mozilla-services/events{/privacy}","received_events_url":"https://api.github.com/users/mozilla-services/received_events","type":"Organization","site_admin":false},"repo":{"id":39374287,"name":"syncto","full_name":"mozilla-services/syncto","owner":{"login":"mozilla-services","id":1066228,"avatar_url":"https://avatars.githubusercontent.com/u/1066228?v=3","gravatar_id":"","url":"https://api.github.com/users/mozilla-services","html_url":"https://github.com/mozilla-services","followers_url":"https://api.github.com/users/mozilla-services/followers","following_url":"https://api.github.com/users/mozilla-services/following{/other_user}","gists_url":"https://api.github.com/users/mozilla-services/gists{/gist_id}","starred_url":"https://api.github.com/users/mozilla-services/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mozilla-services/subscriptions","organizations_url":"https://api.github.com/users/mozilla-services/orgs","repos_url":"https://api.github.com/users/mozilla-services/repos","events_url":"https://api.github.com/users/mozilla-services/events{/privacy}","received_events_url":"https://api.github.com/users/mozilla-services/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mozilla-services/syncto","description":"Sync to Kinto bridge (read and write data from/to sync with the Kinto interface)","fork":false,"url":"https://api.github.com/repos/mozilla-services/syncto","forks_url":"https://api.github.com/repos/mozilla-services/syncto/forks","keys_url":"https://api.github.com/repos/mozilla-services/syncto/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mozilla-services/syncto/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mozilla-services/syncto/teams","hooks_url":"https://api.github.com/repos/mozilla-services/syncto/hooks","issue_events_url":"https://api.github.com/repos/mozilla-services/syncto/issues/events{/number}","events_url":"https://api.github.com/repos/mozilla-services/syncto/events","assignees_url":"https://api.github.com/repos/mozilla-services/syncto/assignees{/user}","branches_url":"https://api.github.com/repos/mozilla-services/syncto/branches{/branch}","tags_url":"https://api.github.com/repos/mozilla-services/syncto/tags","blobs_url":"https://api.github.com/repos/mozilla-services/syncto/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mozilla-services/syncto/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mozilla-services/syncto/git/refs{/sha}","trees_url":"https://api.github.com/repos/mozilla-services/syncto/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mozilla-services/syncto/statuses/{sha}","languages_url":"https://api.github.com/repos/mozilla-services/syncto/languages","stargazers_url":"https://api.github.com/repos/mozilla-services/syncto/stargazers","contributors_url":"https://api.github.com/repos/mozilla-services/syncto/contributors","subscribers_url":"https://api.github.com/repos/mozilla-services/syncto/subscribers","subscription_url":"https://api.github.com/repos/mozilla-services/syncto/subscription","commits_url":"https://api.github.com/repos/mozilla-services/syncto/commits{/sha}","git_commits_url":"https://api.github.com/repos/mozilla-services/syncto/git/commits{/sha}","comments_url":"https://api.github.com/repos/mozilla-services/syncto/comments{/number}","issue_comment_url":"https://api.github.com/repos/mozilla-services/syncto/issues/comments{/number}","contents_url":"https://api.github.com/repos/mozilla-services/syncto/contents/{+path}","compare_url":"https://api.github.com/repos/mozilla-services/syncto/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mozilla-services/syncto/merges","archive_url":"https://api.github.com/repos/mozilla-services/syncto/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mozilla-services/syncto/downloads","issues_url":"https://api.github.com/repos/mozilla-services/syncto/issues{/number}","pulls_url":"https://api.github.com/repos/mozilla-services/syncto/pulls{/number}","milestones_url":"https://api.github.com/repos/mozilla-services/syncto/milestones{/number}","notifications_url":"https://api.github.com/repos/mozilla-services/syncto/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mozilla-services/syncto/labels{/name}","releases_url":"https://api.github.com/repos/mozilla-services/syncto/releases{/id}","created_at":"2015-07-20T09:14:26Z","updated_at":"2015-09-10T07:37:27Z","pushed_at":"2015-10-06T22:30:15Z","git_url":"git://github.com/mozilla-services/syncto.git","ssh_url":"git@github.com:mozilla-services/syncto.git","clone_url":"https://github.com/mozilla-services/syncto.git","svn_url":"https://github.com/mozilla-services/syncto","homepage":"https://wiki.mozilla.org/Firefox_OS/Syncto","size":795,"stargazers_count":1,"watchers_count":1,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":4,"forks":3,"open_issues":4,"watchers":1,"default_branch":"master"}},"base":{"label":"mozilla-services:master","ref":"master","sha":"9f2ce0c461f13fec8369249015424d787b131154","user":{"login":"mozilla-services","id":1066228,"avatar_url":"https://avatars.githubusercontent.com/u/1066228?v=3","gravatar_id":"","url":"https://api.github.com/users/mozilla-services","html_url":"https://github.com/mozilla-services","followers_url":"https://api.github.com/users/mozilla-services/followers","following_url":"https://api.github.com/users/mozilla-services/following{/other_user}","gists_url":"https://api.github.com/users/mozilla-services/gists{/gist_id}","starred_url":"https://api.github.com/users/mozilla-services/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mozilla-services/subscriptions","organizations_url":"https://api.github.com/users/mozilla-services/orgs","repos_url":"https://api.github.com/users/mozilla-services/repos","events_url":"https://api.github.com/users/mozilla-services/events{/privacy}","received_events_url":"https://api.github.com/users/mozilla-services/received_events","type":"Organization","site_admin":false},"repo":{"id":39374287,"name":"syncto","full_name":"mozilla-services/syncto","owner":{"login":"mozilla-services","id":1066228,"avatar_url":"https://avatars.githubusercontent.com/u/1066228?v=3","gravatar_id":"","url":"https://api.github.com/users/mozilla-services","html_url":"https://github.com/mozilla-services","followers_url":"https://api.github.com/users/mozilla-services/followers","following_url":"https://api.github.com/users/mozilla-services/following{/other_user}","gists_url":"https://api.github.com/users/mozilla-services/gists{/gist_id}","starred_url":"https://api.github.com/users/mozilla-services/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mozilla-services/subscriptions","organizations_url":"https://api.github.com/users/mozilla-services/orgs","repos_url":"https://api.github.com/users/mozilla-services/repos","events_url":"https://api.github.com/users/mozilla-services/events{/privacy}","received_events_url":"https://api.github.com/users/mozilla-services/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mozilla-services/syncto","description":"Sync to Kinto bridge (read and write data from/to sync with the Kinto interface)","fork":false,"url":"https://api.github.com/repos/mozilla-services/syncto","forks_url":"https://api.github.com/repos/mozilla-services/syncto/forks","keys_url":"https://api.github.com/repos/mozilla-services/syncto/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mozilla-services/syncto/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mozilla-services/syncto/teams","hooks_url":"https://api.github.com/repos/mozilla-services/syncto/hooks","issue_events_url":"https://api.github.com/repos/mozilla-services/syncto/issues/events{/number}","events_url":"https://api.github.com/repos/mozilla-services/syncto/events","assignees_url":"https://api.github.com/repos/mozilla-services/syncto/assignees{/user}","branches_url":"https://api.github.com/repos/mozilla-services/syncto/branches{/branch}","tags_url":"https://api.github.com/repos/mozilla-services/syncto/tags","blobs_url":"https://api.github.com/repos/mozilla-services/syncto/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mozilla-services/syncto/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mozilla-services/syncto/git/refs{/sha}","trees_url":"https://api.github.com/repos/mozilla-services/syncto/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mozilla-services/syncto/statuses/{sha}","languages_url":"https://api.github.com/repos/mozilla-services/syncto/languages","stargazers_url":"https://api.github.com/repos/mozilla-services/syncto/stargazers","contributors_url":"https://api.github.com/repos/mozilla-services/syncto/contributors","subscribers_url":"https://api.github.com/repos/mozilla-services/syncto/subscribers","subscription_url":"https://api.github.com/repos/mozilla-services/syncto/subscription","commits_url":"https://api.github.com/repos/mozilla-services/syncto/commits{/sha}","git_commits_url":"https://api.github.com/repos/mozilla-services/syncto/git/commits{/sha}","comments_url":"https://api.github.com/repos/mozilla-services/syncto/comments{/number}","issue_comment_url":"https://api.github.com/repos/mozilla-services/syncto/issues/comments{/number}","contents_url":"https://api.github.com/repos/mozilla-services/syncto/contents/{+path}","compare_url":"https://api.github.com/repos/mozilla-services/syncto/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mozilla-services/syncto/merges","archive_url":"https://api.github.com/repos/mozilla-services/syncto/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mozilla-services/syncto/downloads","issues_url":"https://api.github.com/repos/mozilla-services/syncto/issues{/number}","pulls_url":"https://api.github.com/repos/mozilla-services/syncto/pulls{/number}","milestones_url":"https://api.github.com/repos/mozilla-services/syncto/milestones{/number}","notifications_url":"https://api.github.com/repos/mozilla-services/syncto/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mozilla-services/syncto/labels{/name}","releases_url":"https://api.github.com/repos/mozilla-services/syncto/releases{/id}","created_at":"2015-07-20T09:14:26Z","updated_at":"2015-09-10T07:37:27Z","pushed_at":"2015-10-06T22:30:15Z","git_url":"git://github.com/mozilla-services/syncto.git","ssh_url":"git@github.com:mozilla-services/syncto.git","clone_url":"https://github.com/mozilla-services/syncto.git","svn_url":"https://github.com/mozilla-services/syncto","homepage":"https://wiki.mozilla.org/Firefox_OS/Syncto","size":795,"stargazers_count":1,"watchers_count":1,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":4,"forks":3,"open_issues":4,"watchers":1,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mozilla-services/syncto/pulls/20"},"html":{"href":"https://github.com/mozilla-services/syncto/pull/20"},"issue":{"href":"https://api.github.com/repos/mozilla-services/syncto/issues/20"},"comments":{"href":"https://api.github.com/repos/mozilla-services/syncto/issues/20/comments"},"review_comments":{"href":"https://api.github.com/repos/mozilla-services/syncto/pulls/20/comments"},"review_comment":{"href":"https://api.github.com/repos/mozilla-services/syncto/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mozilla-services/syncto/pulls/20/commits"},"statuses":{"href":"https://api.github.com/repos/mozilla-services/syncto/statuses/a4d63a04e728020c14be62c5eea480fd769568c0"}}}}