{"_id":"58cb0e0c2a8c78390025114b","version":{"_id":"556cd8aec14029190092d295","__v":14,"project":"556cd8aec14029190092d292","createdAt":"2015-06-01T22:11:58.756Z","releaseDate":"2015-06-01T22:11:58.756Z","categories":["556cd8afc14029190092d296","55ca5a55241e790d004f47ea","55dc9fdb4f535537007da1b2","55dc9fdfc755b63700dc843c","55fdb08c4bebdf17004130d4","560ef4c2a36c610d00e7013e","5613db296a092921004c30c2","56156581dc8aea0d002475e8","56169d1ee98f5517005627a8","5622fde7de7dc01700c6dd5f","56cf75f3336aa60b0086a495","5818f3c02093901b00bcf91a","582f7ff88ea0800f0035639a","583f30c110448a2500dd990f"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":0,"parentDoc":null,"category":{"_id":"5622fde7de7dc01700c6dd5f","pages":["5622fe48d51d480d0064fc77","5623104906481c0d00e53162","56231066de7dc01700c6dd65","5627f69388948617002a0996"],"project":"556cd8aec14029190092d292","__v":4,"version":"556cd8aec14029190092d295","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-18T02:03:19.875Z","from_sync":false,"order":3,"slug":"authentication-and-authorization","title":"Authentication and Authorization"},"project":"556cd8aec14029190092d292","user":"589a27c93857222f001e486e","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-03-16T22:13:32.879Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"To develop an app that is used only by you or to access your own data, you can generate a Personal Access Token. These tokens can be configured with scopes that restrict the token to only be able to access certain parts of your account.\n[block:api-header]\n{\n  \"title\": \"How To Generate A Personal Access Token\"\n}\n[/block]\n1. From your user menu, go to **Settings** \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/778241c-step1.png\",\n        \"step1.png\",\n        312,\n        459,\n        \"#ab733b\"\n      ]\n    }\n  ]\n}\n[/block]\n2. Click the **API & Integrations Tab**, then click the **Generate New Token**  button.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dfa6cd7-step2.png\",\n        \"step2.png\",\n        1008,\n        665,\n        \"#f4f0f0\"\n      ]\n    }\n  ]\n}\n[/block]\n3. Enter a name, then choose the scopes you need for your token. Scopes allow you to set the permissions of your token.\n\nFor most ecommerce integrations we recommend selecting the following scopes:\n\n* public\n* read_listings\n* write_listings\n* read_orders\n* write_orders\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f69cebb-step3.png\",\n        \"step3.png\",\n        691,\n        1095,\n        \"#f1eaea\"\n      ],\n      \"sizing\": \"80\"\n    }\n  ]\n}\n[/block]\n4. Your token is now created.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/01dc145-Screen_Shot_2017-03-16_at_5.07.11_PM.png\",\n        \"Screen Shot 2017-03-16 at 5.07.11 PM.png\",\n        976,\n        353,\n        \"#e7f1e5\"\n      ]\n    }\n  ]\n}\n[/block]\n5. Use this token in subsequent requests in the Authorization header\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -i -H 'Authorization: Bearer 774c5112345abcd3f32e662e885e043672f6c5d36e14c1d98730170cea3' -X GET 'https://api.reverb.com/api/listings'\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"generating-personal-access-tokens","type":"basic","title":"Generating Personal Access Tokens"}

Generating Personal Access Tokens


To develop an app that is used only by you or to access your own data, you can generate a Personal Access Token. These tokens can be configured with scopes that restrict the token to only be able to access certain parts of your account. [block:api-header] { "title": "How To Generate A Personal Access Token" } [/block] 1. From your user menu, go to **Settings** [block:image] { "images": [ { "image": [ "https://files.readme.io/778241c-step1.png", "step1.png", 312, 459, "#ab733b" ] } ] } [/block] 2. Click the **API & Integrations Tab**, then click the **Generate New Token** button. [block:image] { "images": [ { "image": [ "https://files.readme.io/dfa6cd7-step2.png", "step2.png", 1008, 665, "#f4f0f0" ] } ] } [/block] 3. Enter a name, then choose the scopes you need for your token. Scopes allow you to set the permissions of your token. For most ecommerce integrations we recommend selecting the following scopes: * public * read_listings * write_listings * read_orders * write_orders [block:image] { "images": [ { "image": [ "https://files.readme.io/f69cebb-step3.png", "step3.png", 691, 1095, "#f1eaea" ], "sizing": "80" } ] } [/block] 4. Your token is now created. [block:image] { "images": [ { "image": [ "https://files.readme.io/01dc145-Screen_Shot_2017-03-16_at_5.07.11_PM.png", "Screen Shot 2017-03-16 at 5.07.11 PM.png", 976, 353, "#e7f1e5" ] } ] } [/block] 5. Use this token in subsequent requests in the Authorization header [block:code] { "codes": [ { "code": "curl -i -H 'Authorization: Bearer 774c5112345abcd3f32e662e885e043672f6c5d36e14c1d98730170cea3' -X GET 'https://api.reverb.com/api/listings'", "language": "curl" } ] } [/block]