{"_id":"55b96120b42b610d00c9b298","user":"542954f6cd35120800fceca0","category":{"_id":"55b9611fb42b610d00c9b28f","pages":["55b96120b42b610d00c9b298","55b96120b42b610d00c9b299","56a3ee7395be510d00cb9c3b","56e6bb8c05390f2b002d5ceb"],"project":"54295508cd35120800fceca2","__v":3,"version":"55b9611eb42b610d00c9b28d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-29T22:40:44.562Z","from_sync":false,"order":1,"slug":"authentication","title":"Authentication"},"project":"54295508cd35120800fceca2","version":{"_id":"55b9611eb42b610d00c9b28d","__v":4,"project":"54295508cd35120800fceca2","createdAt":"2015-07-29T23:26:22.532Z","releaseDate":"2015-07-29T23:26:22.532Z","categories":["55b9611fb42b610d00c9b28e","55b9611fb42b610d00c9b28f","55b9611fb42b610d00c9b290","55b9611fb42b610d00c9b291","55b9611fb42b610d00c9b292","55b9611fb42b610d00c9b293","55bc25ee76754617002aa893","56ae7f53be2c040d00d5a09b","56ae7f7b0c1cab0d009f65d1"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0"},"__v":4,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-07-29T22:41:14.550Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What is an API Token?\"\n}\n[/block]\nAn API Token is a string that let's you perform actions directly on the API as the account linked to that token.\nIt looks something like: \"*1b61610b-6d09-420f-9562-552dbf5512af*\" and should be stored in a safe place. Anyone who has a token, can perform any action for the corresponding account.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"When do I use an API Token?\"\n}\n[/block]\nYou use an API Token when you want to **use a Yo account that you own, via code**.\nIf you want to create a Yo client that allows other people to send Yos then check out our  [OAuth page](https://dash.readme.io/project/yoapp/v2.0/docs/oauth) \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"How do I create an account and get its API Token?\"\n}\n[/block]\nLet's start by logging in to https://dev.justyo.co (here we use our personal Yo account credentials)\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/mjdnOsO4QF9Sak02UUEo_Screen%20Shot%202015-07-29%20at%203.43.53%20PM.png\",\n        \"Screen Shot 2015-07-29 at 3.43.53 PM.png\",\n        \"1010\",\n        \"721\",\n        \"#843c9c\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nOr signing up if we don't have a Yo account\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/YiSTKju7RjKPQbdgoh1i_Screen%20Shot%202015-07-29%20at%203.45.04%20PM.png\",\n        \"Screen Shot 2015-07-29 at 3.45.04 PM.png\",\n        \"1010\",\n        \"744\",\n        \"#8c44a4\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d8s3BsMRVOzh7fGYpYjX_Screen%20Shot%202015-07-29%20at%203.45.34%20PM.png\",\n        \"Screen Shot 2015-07-29 at 3.45.34 PM.png\",\n        \"1010\",\n        \"744\",\n        \"#4a627b\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/nHtKu76SR9yMztLcvEWB_Screen%20Shot%202015-07-29%20at%203.46.46%20PM.png\",\n        \"Screen Shot 2015-07-29 at 3.46.46 PM.png\",\n        \"1010\",\n        \"744\",\n        \"#4b6179\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ewfVnYo9QsO6SMb6qNnM_Screen%20Shot%202015-07-29%20at%203.46.53%20PM.png\",\n        \"Screen Shot 2015-07-29 at 3.46.53 PM.png\",\n        \"1010\",\n        \"744\",\n        \"#54687f\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/jCly135lSnWXP6Rq2avn_Screen%20Shot%202015-07-29%20at%203.47.31%20PM.png\",\n        \"Screen Shot 2015-07-29 at 3.47.31 PM.png\",\n        \"1010\",\n        \"744\",\n        \"#496078\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nNow that have your API Token, check out our Code Samples!\n\n[block:html]\n{\n  \"html\": \"<div></div>\\n<ul><li><a href=\\\"/docs/python\\\"><span>Python</span></a></li><li><a href=\\\"/docs/ruby\\\"><span>Ruby</span></a></li><li><a href=\\\"/docs/php\\\"><span>PHP</span></a></li><li><a href=\\\"/docs/nodejs\\\"><span>NodeJS</span></a></li><li><a href=\\\"/docs/javascript\\\"><span>JavaScript (Client side)</span></a></li><li><a href=\\\"/docs/go\\\"><span>Go</span></a></li><li><a href=\\\"/docs/objective-c\\\"><span>Objective C</span></a></li><li><a href=\\\"/docs/java\\\"><span>Java</span></a></li><li><a href=\\\"/docs/c\\\"><span>C#</span></a></li><li><a href=\\\"/docs/perl\\\"><span>Perl</span></a></li><li><a href=\\\"/docs/scala\\\"><span>Scala</span></a></li><li><a href=\\\"/docs/haskell\\\"><span>Haskell</span></a></li></ul>\\n<style></style>\"\n}\n[/block]","excerpt":"What are they? When do I use them?","slug":"api-tokens","type":"basic","title":"API Tokens"}

API Tokens

What are they? When do I use them?

[block:api-header] { "type": "basic", "title": "What is an API Token?" } [/block] An API Token is a string that let's you perform actions directly on the API as the account linked to that token. It looks something like: "*1b61610b-6d09-420f-9562-552dbf5512af*" and should be stored in a safe place. Anyone who has a token, can perform any action for the corresponding account. [block:api-header] { "type": "basic", "title": "When do I use an API Token?" } [/block] You use an API Token when you want to **use a Yo account that you own, via code**. If you want to create a Yo client that allows other people to send Yos then check out our [OAuth page](https://dash.readme.io/project/yoapp/v2.0/docs/oauth) [block:api-header] { "type": "basic", "title": "How do I create an account and get its API Token?" } [/block] Let's start by logging in to https://dev.justyo.co (here we use our personal Yo account credentials) [block:image] { "images": [ { "image": [ "https://files.readme.io/mjdnOsO4QF9Sak02UUEo_Screen%20Shot%202015-07-29%20at%203.43.53%20PM.png", "Screen Shot 2015-07-29 at 3.43.53 PM.png", "1010", "721", "#843c9c", "" ] } ] } [/block] Or signing up if we don't have a Yo account [block:image] { "images": [ { "image": [ "https://files.readme.io/YiSTKju7RjKPQbdgoh1i_Screen%20Shot%202015-07-29%20at%203.45.04%20PM.png", "Screen Shot 2015-07-29 at 3.45.04 PM.png", "1010", "744", "#8c44a4", "" ] } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/d8s3BsMRVOzh7fGYpYjX_Screen%20Shot%202015-07-29%20at%203.45.34%20PM.png", "Screen Shot 2015-07-29 at 3.45.34 PM.png", "1010", "744", "#4a627b", "" ] } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/nHtKu76SR9yMztLcvEWB_Screen%20Shot%202015-07-29%20at%203.46.46%20PM.png", "Screen Shot 2015-07-29 at 3.46.46 PM.png", "1010", "744", "#4b6179", "" ] } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/ewfVnYo9QsO6SMb6qNnM_Screen%20Shot%202015-07-29%20at%203.46.53%20PM.png", "Screen Shot 2015-07-29 at 3.46.53 PM.png", "1010", "744", "#54687f", "" ] } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/jCly135lSnWXP6Rq2avn_Screen%20Shot%202015-07-29%20at%203.47.31%20PM.png", "Screen Shot 2015-07-29 at 3.47.31 PM.png", "1010", "744", "#496078", "" ] } ] } [/block] Now that have your API Token, check out our Code Samples! [block:html] { "html": "<div></div>\n<ul><li><a href=\"/docs/python\"><span>Python</span></a></li><li><a href=\"/docs/ruby\"><span>Ruby</span></a></li><li><a href=\"/docs/php\"><span>PHP</span></a></li><li><a href=\"/docs/nodejs\"><span>NodeJS</span></a></li><li><a href=\"/docs/javascript\"><span>JavaScript (Client side)</span></a></li><li><a href=\"/docs/go\"><span>Go</span></a></li><li><a href=\"/docs/objective-c\"><span>Objective C</span></a></li><li><a href=\"/docs/java\"><span>Java</span></a></li><li><a href=\"/docs/c\"><span>C#</span></a></li><li><a href=\"/docs/perl\"><span>Perl</span></a></li><li><a href=\"/docs/scala\"><span>Scala</span></a></li><li><a href=\"/docs/haskell\"><span>Haskell</span></a></li></ul>\n<style></style>" } [/block]