Follow

Get Social Provider by User Name

The Get Social Providers by Username command returns the Social Providers for a specified Social Network user.  

Arguments

The Get Social Providers by User Name command requires the following arguments: Command, Realm, Password, Provider Name, and User Name.

api_web?r=myrealm&p=mypass&c=getsocialproviderbyusername&provider=facebook&username=myemail@mydomain.com

The command is ‘getsocialproviderbyusername’, the realm is ‘myrealm’ and the password is ‘mypass’, the provider is id 'facebook', and the Social Network user is 'myemail@mydomain.com’.

The Get Social Provider by User Name command supports the following arguments:

 

Name

Req?

Description

Argument

Command

Yes

Defines the command to use.

cmd= getsocialproviderbyusername

c= getsocialproviderbyusername

Realm

Yes

Name of the realm to run the command.  This is required, and the command will fail if the realm and password do not match.

realm=[realm_name]

r=[realm_name]

Password

Yes

Authentication code for API access.  This is required, and the command will fail if the realm and password do not match.

pwd=[password]

p=[password]

Social Provider Yes Name for the Social Provider in the realm.  Current provider strings include: facebook, twitter, linkedin provider=[social_provider_name]
User Name Yes Identifier of the Social Network user. username=[username]
Output Format   To specify the format of the list output, use one of two arguments.  If no argument is included, the default output is space-delimited plain text string, which may not include all data columns.

csv=1 or

output_format=[csv,csv_tab, csv_pipe,xml]

Header   To define the data with a label, use the Header argument.  This can only be used in conjunction with the output format, and does not affect XML.

headers=[0,1]

DEFAULT==0

 

Example

Using all commands and arguments (please note the command is wrapped for display purposes only):

api_web?r=myrealm&p=mypass&c=getsocialproviderbyusername&provider=facebook&username=myemail@mydomain.com&output_format=csv&headers=1

Successful results return:

"social_provider_id","provider","username"

"89","FACEBOOK","myemail@mydomain.com"

Results

The Get Social Provider by User Name command outputs either the results of the search or a FAILURE message. 

SUCCESS

The Get Social Provider by User Name command does not explicitly return a Success code.  Instead, it outputs the template id and name in plain text format.  Use the Output Format argument to return the results in an alternate format.

FAILURE

A Get Social Provider by User Name command will fail for several reasons, such as if no Social Providers exist in the realm.  The result format is:

FAILURE: [Reason]  

 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk