API - Get user details

Get User Details

This API can be used to get user's details in the microsite. The API is a restrictive one and can be called by an admin of the site only. Any other user trying to invoke this API would result in an error being returned by the API.

API Details

Signature of API call

connection.invokeApi(String uri, String realUserName, Map<String, String> requestParameters);

See details about invoking API in general

 

Parameter 1 - URI

userService.do

 

Parameter 2 - UserName

Username of any site administrator

 

Parameter 3 - Request Parameters

Name Value
dispatch get
id or userName or openId must be specified
id user id, e.g. a570e68e-2134-11e6-b63c-6ce229284b01
userName user name of the user. E.g. jdoe
openId openId can be used to uniquely identify the user (this field can be used as a custom unique key)
pwToken optional. pass true to retrieve password reset token and password reset urls for this user

 

Response

1. Response on successfully finding the user

HTTP Response Code = HttpServletResponse.SC_OK

Response XML

<response code="0">
    <msgs>
         <msg>
             <code>0</code>
             <value><![CDATA[Success]]></value>
         </msg>
    </msgs>

<data>
    <user id="0a94dd08-bcf2-11e3-9f5e-ed9f54c5e015" siteRole="STUDENT" status="ACTIVE">
        <userName><![CDATA[jdoe]]></userName>
        <firstName><![CDATA[John]]></firstName>
        <lastName><![CDATA[Doe]]></lastName>
        <email><![CDATA[jdoe@edubrite.com]]></email>       

        <passwordToken><![CDATA[xxxxxxxxxx]]></passwordToken>
        <passwordResetUrl><![CDATA[http://microsite-url.edubrite.us/oltpublish/site/resetpasswd.do?token=xxxxxxxxxxxxx]]></passwordResetUrl>
               
        <customProperties>
                <prop>
                    <name><![CDATA[address]]></name>
                    <value><![CDATA[4128 Business Center Dr]]></value>
                    <displayValue><![CDATA[4128 Business Center Dr]]></displayValue>
                </prop>
        </customProperties>
            <groupMembers>
                    <groupMember groupId="ba2d8118-a91d-11e3-9904-ce5a5bb8887f"
                        role="STUDENT">
                        <groupName><![CDATA[Level0]]></groupName>
                    </groupMember>                
                    <groupMember groupId="b8cbee9e-8d3f-11e3-afb2-a1819f9d3329" parentId="b8befcf2-8d3f-11e3-afb2-a1819f9d3329"
                        role="STUDENT">
                        <groupName><![CDATA[Training]]></groupName>
                    </groupMember>
                
                    <groupMember groupId="b8befcf2-8d3f-11e3-afb2-a1819f9d3329"
                        role="STUDENT">
                        <groupName><![CDATA[Corporate]]></groupName>
                    </groupMember>
                
                    <groupMember groupId="d7fd60c8-f881-11e4-aa97-cd61805e5592"
                        role="STUDENT">
                        <groupName><![CDATA[Sales]]></groupName>
                    </groupMember>
            </groupMembers>
    </user>
</data>

</response>

 

2. Response for unauthorized access

HTTP Response Code = HttpServletResponse.SC_UNAUTHORIZED

Response XML

<response code="-1">
    <msgs>
         <msg>
             <code>0005</code>
             <value><![CDATA[You are not allowed to perform this action.]]></value>
         </msg>
    </msgs>
</response>

3. Response when user is not found

<response code="-1">
<msgs>
     <msg>
         <code>0004</code>
         <value><![CDATA[Unable to find User with matching id]]></value>
     </msg>
</msgs>
</response>

Code Snippet

    /*  Check API Call for detail generic code */
    Map<String, String> parameters = new HashMap<String, String>();
    parameters.put("dispatch", "get");

    parameters.put("userName", "jdoe");
   
    String retStr = connection.invokeApi("userService.do", "chenry", parameters);
    System.out.println(retStr);

   

 

 


Rating: