{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"never","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Receiving a Yo","type":"basic","slug":"receiving-a-yo-with-the-api","excerpt":"","body":"To receive a Yo on an API account, all you need to do is setup a \"**Callback URL**\" in the developer dashboard: https://dashboard.justyo.co. \nThis callback URL will receive a GET request every time someone sends a Yo to your API account.\n\nThere will be GET parameters: \n\"***username***\" - the username that sent the Yo, which is now subscribed to your service and will receive a Yo when you use \"yoall\"\n\n\"***link***\" - (Optionl) If the user provided a link, you will get it as a \"link\" parameter\n\n\"***location***\" - (Optional) If the user provided location you get a parameter formatted as: \"latitude;longitude\"\nFor example: \"42.360091;-71.094159\" which are the latitude and longitude of MIT: \nhttps://www.google.com/maps/search/42.360091,-71.0941599\n\nWe recommend you use [ngrok](https://ngrok.com/) while development to expose your local development server and set it as the callback URL\n\nEvery time the user Yo's your account our servers will hit your callback URL like this:\nhttp://yourcallbackurl.com/yourendpoint?username=THEYOER&location=42.360091;-71.094159\n\nYou can test your server by copying the URL above and replacing *http://yourcallbackurl.com/yourendpoint* with your callback URL\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/BulzUW19SXOpqAZSLl0X_Screen%20Shot%202016-02-22%20at%2011.26.47%20AM.png\",\n \"Screen Shot 2016-02-22 at 11.26.47 AM.png\",\n \"768\",\n \"862\",\n \"#7e534d\",\n \"\"\n ],\n \"caption\": \"In the top bar click \\\"Edit Profile\\\" and set your callback URL\"\n }\n ]\n}\n[/block]","updates":["5434553cedce0408004096ce","55ad5a5133616a0d00599d70"],"order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"55b96120b42b610d00c9b29f","__v":3,"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Webhooks","slug":"webhooks","order":4,"from_sync":false,"reference":false,"_id":"56ae7f53be2c040d00d5a09b","createdAt":"2016-01-31T21:40:35.776Z","__v":0,"project":"54295508cd35120800fceca2","version":"55b9611eb42b610d00c9b28d"},"version":{"version":"2.0","version_clean":"2.0.0","codename":"","is_stable":true,"is_beta":true,"is_hidden":false,"is_deprecated":false,"categories":["55b9611fb42b610d00c9b28e","55b9611fb42b610d00c9b28f","55b9611fb42b610d00c9b290","55b9611fb42b610d00c9b291","55b9611fb42b610d00c9b292","55b9611fb42b610d00c9b293","55bc25ee76754617002aa893","56ae7f53be2c040d00d5a09b","56ae7f7b0c1cab0d009f65d1"],"_id":"55b9611eb42b610d00c9b28d","__v":4,"createdAt":"2015-07-29T23:26:22.532Z","project":"54295508cd35120800fceca2","releaseDate":"2015-07-29T23:26:22.532Z"},"createdAt":"2014-09-29T22:47:31.127Z","githubsync":"","project":"54295508cd35120800fceca2","user":"542954f6cd35120800fceca0"}