{"_id":"56c41abb4040602b0064cea5","githubsync":"","parentDoc":null,"user":"56b98db7bb36440d0001f492","__v":8,"project":"56bc8e679afb8b0d00d62dcf","category":{"_id":"56c4181cc4796b0d007ef039","version":"56bc8e689afb8b0d00d62dd2","__v":26,"project":"56bc8e679afb8b0d00d62dcf","pages":["56c4192dbc41330d009f25fd","56c4196434df460d00c2bece","56c419814f0aed1700afaba6","56c4198dbc41330d009f25ff","56c419962e75e01700986053","56c4199f54b6030d00ec29a4","56c419a8bb64720d00552b8b","56c419b1bb64720d00552b8d","56c419b92d97560d00e23cf9","56c419c64040602b0064cea3","56c419d4bc41330d009f2601","56c419de70187b17005f43b9","56c419ea6063071700500cfe","56c419fa54b6030d00ec29a6","56c41a096063071700500d00","56c41a1834df460d00c2bed0","56c41a773d30210d00ea8517","56c41a86c4796b0d007ef03e","56c41a904f0aed1700afaba8","56c41a9fbc41330d009f2603","56c41aaa521f350d00d348fe","56c41abb4040602b0064cea5","56c41ad24040602b0064cea7","56c41ade48213b1700af6e28","56c41aeb3d30210d00ea8519","56c41af948213b1700af6e2a"],"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-17T06:50:04.339Z","from_sync":false,"order":2,"slug":"users","title":"Users"},"version":{"_id":"56bc8e689afb8b0d00d62dd2","project":"56bc8e679afb8b0d00d62dcf","__v":18,"createdAt":"2016-02-11T13:36:40.146Z","releaseDate":"2016-02-11T13:36:40.146Z","categories":["56bc8e689afb8b0d00d62dd3","56c3c837bc41330d009f25ed","56c3c83e521f350d00d348eb","56c3c8452d97560d00e23cd8","56c3c85234df460d00c2beb8","56c4180d70187b17005f43b4","56c418162d97560d00e23cf6","56c4181cc4796b0d007ef039","56c4182370187b17005f43b5","56c418292e75e01700986052","56c4183328bd680d005e7ac6","56c4183bbb64720d00552b88","56c418414040602b0064cea0","56c4184754b6030d00ec29a1","56c4184c28bd680d005e7ac7","56c4185370187b17005f43b6","56c4185b6063071700500cfc","582a98b6f8c0a0190053d7a5"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-17T07:01:15.109Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":21,"body":"[block:api-header]\n{\n  \"type\": \"get\",\n  \"title\": \"/users/identities/{identityProviderName}/{identityId}\"\n}\n[/block]\nLook up a Buddy user via third party identity.\n\nLet's say your app's users have Twitter accounts. The app could add identities for them with an `identityProviderName` of `twitter`, and the `identityId` being the user's Twitter handle. Your app could then map from Twitter handles to Buddy user accounts or other identity providers.  This is extremely useful for constructing social network maps or other graphs within a Buddy app.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Buddy.get('/users/identities/my_identityProviderName/my_identityId',\\n\\t\\tfunction(err, result) {\\n\\t\\t\\t \\n\\t\\t\\tif (result.success) {\\n\\t\\t\\t\\t// Do something with the result!\\n\\t\\t\\t} else { \\n\\t\\t\\t\\t// Otherwise log the error\\n\\t\\t\\t\\tconsole.log(err); \\n\\t\\t\\t} \\n\\t\\t}\\n\\t);\",\n      \"language\": \"javascript\"\n    },\n    {\n      \"code\": \"[Buddy GET::::at:::\\\"/users/identities/my_identityProviderName/my_identityId\\\" parameters:nil class:[BPUser class] callback:^(id obj, NSError *error) {\\n\\t// Your callback code here\\n}];\",\n      \"language\": \"objectivec\",\n      \"name\": \"iOS\"\n    },\n    {\n      \"code\": \"Buddy.get(\\\"/users/identities/my_identityProviderName/my_identityId\\\", null, new BuddyCallback<User>(User.class) {\\n\\[email protected]\\n\\tpublic void completed(BuddyResult<User> result) {\\n\\t\\t// Your callback code here\\n\\t}\\n});\",\n      \"language\": \"java\",\n      \"name\": \"Android\"\n    },\n    {\n      \"code\": \"var result = await Buddy.GetAsync<User>(\\\"/users/identities/my_identityProviderName/my_identityId\\\");\",\n      \"language\": \"csharp\",\n      \"name\": \".NET\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]\n###Path Parameters\n\nThese parameters should be specified as part of the HTTP path.\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"identityProviderNamed\",\n    \"1-0\": \"identityId\",\n    \"0-1\": \"The name of the provider to search.\",\n    \"1-1\": \"The ID of the user being searched for on the given provider.\",\n    \"0-2\": \"string\",\n    \"1-2\": \"string\",\n    \"0-3\": \"Required\",\n    \"1-3\": \"Required\"\n  },\n  \"cols\": 4,\n  \"rows\": 2\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"status\\\": 200,\\n  \\\"result\\\": \\\"bv.kChbvshdHnDn\\\",\\n  \\\"request_id\\\": \\\"53bf28a8b32fad0db41a9048\\\",\\n  \\\"success\\\": true\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Response\"\n    }\n  ],\n  \"sidebar\": true\n}\n[/block]","excerpt":"","slug":"find-user-by-identity","type":"basic","title":"Find User by Identity"}

Find User by Identity


[block:api-header] { "type": "get", "title": "/users/identities/{identityProviderName}/{identityId}" } [/block] Look up a Buddy user via third party identity. Let's say your app's users have Twitter accounts. The app could add identities for them with an `identityProviderName` of `twitter`, and the `identityId` being the user's Twitter handle. Your app could then map from Twitter handles to Buddy user accounts or other identity providers. This is extremely useful for constructing social network maps or other graphs within a Buddy app. [block:code] { "codes": [ { "code": "Buddy.get('/users/identities/my_identityProviderName/my_identityId',\n\t\tfunction(err, result) {\n\t\t\t \n\t\t\tif (result.success) {\n\t\t\t\t// Do something with the result!\n\t\t\t} else { \n\t\t\t\t// Otherwise log the error\n\t\t\t\tconsole.log(err); \n\t\t\t} \n\t\t}\n\t);", "language": "javascript" }, { "code": "[Buddy GET:@\"/users/identities/my_identityProviderName/my_identityId\" parameters:nil class:[BPUser class] callback:^(id obj, NSError *error) {\n\t// Your callback code here\n}];", "language": "objectivec", "name": "iOS" }, { "code": "Buddy.get(\"/users/identities/my_identityProviderName/my_identityId\", null, new BuddyCallback<User>(User.class) {\n\[email protected]\n\tpublic void completed(BuddyResult<User> result) {\n\t\t// Your callback code here\n\t}\n});", "language": "java", "name": "Android" }, { "code": "var result = await Buddy.GetAsync<User>(\"/users/identities/my_identityProviderName/my_identityId\");", "language": "csharp", "name": ".NET" } ], "sidebar": true } [/block] ###Path Parameters These parameters should be specified as part of the HTTP path. [block:parameters] { "data": { "0-0": "identityProviderNamed", "1-0": "identityId", "0-1": "The name of the provider to search.", "1-1": "The ID of the user being searched for on the given provider.", "0-2": "string", "1-2": "string", "0-3": "Required", "1-3": "Required" }, "cols": 4, "rows": 2 } [/block] [block:code] { "codes": [ { "code": "{\n \"status\": 200,\n \"result\": \"bv.kChbvshdHnDn\",\n \"request_id\": \"53bf28a8b32fad0db41a9048\",\n \"success\": true\n}", "language": "json", "name": "Response" } ], "sidebar": true } [/block]