User Management Service

Almost every app requires User Management, at the simplest level Registration and Authentication. The App42 APIs provides a comprehensive User Management solution to handle users both as App42 Users and Social Users. The service contains operations for managing user creation, authentication, state (revoking, locking, expiry etc.), role management, profile management, password policy, etc. Almost everything that one can do is available through the AppHQ console. These users can be also exported in various formats at the click of a button, if required.

User Management service is designed to be orthogonal. Other App42 services can be used independently of this service, they are not connected or dependent. It can also be integrated with existing CRM, LDAP, Active Directory, etc. This module also works in conjunction with App42 Marketing Automation which provides comprehensive actionable analytics on user’s behavior and the ability to take action e.g. Push Notification, In-App Message, Social Post, Email, Survey, Coupon, Lead Generation, NPS (Net Promoter Score) etc. With App42 MA you can track funnels and cohorts, through which action can be taken as campaigns or on demand.

Along with User Management, the library provides APIs for persistent Session Management across Omni-Channel devices that help in maintaining context based sessions across.

Import Statement
  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. import com.shephertz.app42.paas.sdk.as3.App42API;  
  2. import com.shephertz.app42.paas.sdk.as3.App42Response;  
  3. import com.shephertz.app42.paas.sdk.as3.App42Exception;  
  4. import com.shephertz.app42.paas.sdk.as3.App42BadParameterException;  
  5. import com.shephertz.app42.paas.sdk.as3.App42NotFoundException;   
  6. import com.shephertz.app42.paas.sdk.as3.user.Profile;  
  7. import com.shephertz.app42.paas.sdk.as3.user.UserGender;  
  8. import com.shephertz.app42.paas.sdk.as3.user.User;  
  9. import com.shephertz.app42.paas.sdk.as3.user.UserService;  
Initialize

In order to use the various functions available in a specific API, a developer has to initialize with App42API by passing the apiKey and the secretKey which will become available after the app creation from AppHQ dashboard.

Required Parameters

apiKey - The Application key given when the application was created. secretKey - The secret key corresponding to the application key given when the application was created.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. App42API.initialize("API_KEY","SECRET_KEY");  
Build Service

After initialization, the developer will have to call the buildXXXService method on App42API to get the instance of the particular API that you wish to build. For example, to build an instance of UserService, buildUserService() method needs to be called.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userService:UserService = App42API.buildUserService();   
Create User

This function allows you to create a User session for the specified User.
Note: Username and EmailId should be unique for the App.

Required Parameters

userName - Name of the user for whom the user session is to be created. pwd - Password of the user. emailId - EmailId of the user.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";     
  2. var pwd:String  = "*****";  
  3. var emailId:String = "nick@shephertz.co.in";  
  4. App42API.initialize("API_KEY","SECRET_KEY");  
  5. var userService:UserService = App42API.buildUserService();   
  6. userService.createUser(userName,pwd,emailId, new callback());    
  7. public class callback implements App42CallBack    
  8. {    
  9.     public function onSuccess(response:Object):void    
  10.     {    
  11.         var user:User = User(response);   
  12.         trace("userName is " + user.getUserName());  
  13.         trace("emailId is " + user.getEmail());  
  14.     }    
  15.     public function onException(exception:App42Exception):void    
  16.     {    
  17.         trace("Exception Message " + exception);    
  18.     }    
  19. }    
Create User With Role

This function enables you to create app users along with granting them specific roles.

Required Parameters

userName - Name of the user for whom the user session is to be created. pwd - Password of the user. emailId - EmailId of the user. roleList - List of roles to be assigned to the user.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";     
  2. var pwd:String  = "*****";  
  3. var emailId:String = "nick@shephertz.co.in";  
  4. var roleList:Array = new Array();  
  5. roleList.push("Admin");    
  6. roleList.push("Manager");    
  7. roleList.push("Programmer");    
  8. roleList.push("Tester");    
  9. App42API.initialize("API_KEY","SECRET_KEY");  
  10. var userService:UserService = App42API.buildUserService();   
  11. userService.createUserWithRole(userName,pwd,emailId,roleList, new callback());    
  12. public class callback implements App42CallBack    
  13. {    
  14.     public function onSuccess(response:Object):void    
  15.     {    
  16.         var user:User = User (response);       
  17.         trace("userName is " + user.getUserName());  
  18.         trace("emailId is " + user.getEmail());  
  19.     }    
  20.     public function onException(exception:App42Exception):void    
  21.     {    
  22.         trace("Exception Message " + exception);    
  23.     }    
  24. }    
Create Or Update User Profile

Required Parameters

user - User for which profile has to be created/updated.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";     
  2. var pwd:String  = "*****";  
  3. var bool:Boolean = true;  
  4. var emailId:String = "nick@shephertz.co.in";  
  5. App42API.initialize("API_KEY","SECRET_KEY");  
  6. var userService:UserService = App42API.buildUserService();   
  7. userService.createUser(userName,pwd,emailId, new callback());    
  8. public class callback implements App42CallBack    
  9. {  
  10.     public function onSuccess(response:Object):void    
  11.     {    
  12.         var user:User = User (response);    
  13.         if(bool)   
  14.         {  
  15.             var profile:Profile = user.getProfile();  
  16.             profile.setFirstName("Nick");  
  17.             profile.setLastName("Gill");  
  18.             profile.setSex(UserGender.MALE);  
  19.             profile.setDateOfBirth(new Date());  
  20.             profile.setCity("Houston");  
  21.             profile.setState("Texas");  
  22.             profile.setPincode("74193");  
  23.             profile.setCountry("USA");  
  24.             profile.setMobile("+1-1111-111-111");  
  25.             profile.setHomeLandLine("+1-2222-222-222");  
  26.             profile.setOfficeLandLine("+1-33333-333-333");  
  27.             userService.createOrUpdateProfile(user,new callback());  
  28.             bool = false;  
  29.         }  
  30.         else{  
  31.             var profileObject:Profile = Profile(user.getProfile());  
  32.             trace("FirstName is : " + profileObject.getFirstName());  
  33.             trace("LastName is : " + profileObject.getLastName());  
  34.             trace("Sex is : " + profileObject.getSex());  
  35.             trace("DateOfBirth is : " + profileObject.getDateOfBirth());  
  36.             trace("City is : " + profileObject.getCity());  
  37.             trace("State is : " + profileObject.getState());  
  38.             trace("Pincode is : " + profileObject.getPincode());  
  39.             trace("Country is : " + profileObject.getCountry());  
  40.             trace("MobileNo is  : " + profileObject.getMobile());  
  41.             trace("HomeLandLineNo is : " + profileObject.getHomeLandLine());  
  42.             trace("OfficeLandLineNo is : " + profileObject.getOfficeLandLine());  
  43.         }  
  44.     }     
  45.     public function onException(exception:App42Exception):void    
  46.     {    
  47.         trace("Exception Message " + exception);    
  48.     }   
  49. }    
Authenticate

Authenticate user based on username and password.

Required Parameters

userName - Username that you want to authenticate. pwd - Password that was entered when the user created their profile.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";     
  2. var pwd:String  = "*****";  
  3. App42API.initialize("API_KEY","SECRET_KEY");  
  4. var userService:UserService = App42API.buildUserService();   
  5. userService.authenticate(userName,pwd, new callback());    
  6. public class callback implements App42CallBack    
  7. {    
  8.     public function onSuccess(response:Object):void    
  9.     {    
  10.         var user:User = User(response);  
  11.         trace("userName is " + user.getUserName());  
  12.         trace("sessionId is " + user.getSessionId());  
  13.     }    
  14.     public function onException(exception:App42Exception):void    
  15.     {    
  16.         trace("Exception Message " + exception);    
  17.     }    
  18. }  
Change User Password

Change the password for a user based on their username, only if the old password is valid.

Required Parameters

userName - User whose password has to be changed. oldPwd - Old Password of the user for authentication. newPwd - New Password entered by the user.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";   
  2. var oldPwd:String = "********";  
  3. var newPwd:String = "*******";    
  4. App42API.initialize("API_KEY","SECRET_KEY");  
  5. var userService:UserService = App42API.buildUserService();   
  6. userService.changeUserPassword(userName,oldPwd,newPwd, new callback());    
  7. public class callback implements App42CallBack    
  8. {    
  9.     public function onSuccess(response:Object):void  
  10.     {    
  11.         var response:App42Response = App42Response (response);  
  12.         trace("response is : " + response);  
  13.     }    
  14.     public function onException(exception:App42Exception):void    
  15.     {    
  16.         trace("Exception Message " + exception);    
  17.     }   
  18. }    
Assign Roles

Assign Roles to the existing user.

Required Parameters

userName - Name of the user to whom the roles have to be assigned. roleList - List of roles to be assigned to user.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";    
  2. var roleList:Array = new Array();    
  3. roleList.push("Admin");    
  4. roleList.push("Manager");    
  5. roleList.push("Programmer");    
  6. roleList.push("Tester");    
  7. App42API.initialize("API_KEY","SECRET_KEY");  
  8. var userService:UserService = App42API.buildUserService();   
  9. userService.assignRoles(userName,roleList, new callback());    
  10. public class callback implements App42CallBack    
  11. {     
  12.     public function onSuccess(response:Object):void    
  13.     {    
  14.         var user:User = User(response);  
  15.         trace("userName is : " + user.getUserName());  
  16.         trace("emailId is : " + user.getEmail());  
  17.         for(var i:int=0;i<user.getRoleList().length;i++)  
  18.         {  
  19.             trace("roleList is " + user.getRoleList()[i]);        
  20.         }  
  21.     }    
  22.     public function onException(exception:App42Exception):void    
  23.     {    
  24.         trace("Exception Message " + exception);    
  25.     }   
  26. }    
Get User

Get user details based on username.

Required Parameters

userName - Name of the user whose detailes have to be retrieved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";    
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.getUser(userName, new callback());    
  5. public class callback implements App42CallBack    
  6. {  
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var user:User = User (response);  
  10.         trace("userName is " + user.getUserName());  
  11.         trace("emailId is " + user.getEmail());  
  12.     }      
  13.     public function onException(exception:App42Exception):void    
  14.     {    
  15.         trace("Exception Message " + exception);    
  16.     }    
  17. }    
Get Roles By User

Get the assigned roles based on username.

Required Parameters

userName - Name of the User for whom roles have to be retrieved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";    
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.getRolesByUser(userName, new callback());    
  5. public class callback implements App42CallBack    
  6. {    
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var user:User = User (response);  
  10.         trace("userName is " + user.getUserName());  
  11.         for(var i:int=0;i<user.getRoleList().length;i++)  
  12.         {  
  13.             trace("roleList is " + user.getRoleList()[i]);        
  14.         }  
  15.     }    
  16.     public function onException(exception:App42Exception):void    
  17.     {    
  18.         trace("Exception Message " + exception);    
  19.     }    
  20. }    
Get Users By Role

Get all the Users based on a particular role.

Required Parameters

role - Role based on which Users need to be retrieved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var role:String = "Role of the User";     
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.getUsersByRole(role, new callback() );   
  5. public class callback implements App42CallBack    
  6. {     
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var user:User = User (response);  
  10.         trace("userName is " + user.getUserName());  
  11.         for(var i:int=0;i<user.getRoleList().length;i++)  
  12.         {  
  13.             trace("roleList is " + user.getRoleList()[i]);        
  14.         }  
  15.     }     
  16.     public function onException(exception:App42Exception):void    
  17.     {    
  18.         trace("Exception Message " + exception);    
  19.     }   
  20. }    
Get All Users

Gets All users details.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. App42API.initialize("API_KEY","SECRET_KEY");  
  2. var userService:UserService = App42API.buildUserService();   
  3. userService.getAllUsers(new callback());    
  4. public class callback implements App42CallBack    
  5. {   
  6.     public function onSuccess(response:Object):void    
  7.     {    
  8.         var array:Array = res as Array;  
  9.         for(var i:int = 0;i < array.length;i++){  
  10.             var user:User = User(array[i])  
  11.             trace("userName is : " + user.getUserName());  
  12.             trace("emailId is : " +  user.getEmail());  
  13.         }  
  14.     }     
  15.     public function onException(exception:App42Exception):void    
  16.     {    
  17.         trace("Exception Message " + exception);    
  18.     }    
  19. }    
Get All Users Count

Get the count of all the users.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. App42API.initialize("API_KEY","SECRET_KEY");  
  2. var userService:UserService = App42API.buildUserService();   
  3. userService.getAllUsersCount(new callback());    
  4. public class callback implements App42CallBack    
  5. {    
  6.     public function onSuccess(response:Object):void    
  7.     {    
  8.         var app42Response:App42Response = App42Response(response);    
  9.         trace("TotalRecords is : " + app42Response.getTotalRecords());  
  10.     }    
  11.     public function onException(exception:App42Exception):void    
  12.     {    
  13.         trace("Exception Message " + exception);    
  14.     }    
  15. }    
Get All Users Paging

Get All users by Paging.

Required Parameters

max - Maximum number of records to be fetched. offset - From where the records are to be fetched.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var max:int = 1;  
  2. var offset:int = 0;  
  3. App42API.initialize("API_KEY","SECRET_KEY");  
  4. var userService:UserService = App42API.buildUserService();   
  5. userService.getAllUsersByPaging(max,offset,new callback());    
  6. public class callback implements App42CallBack    
  7. {    
  8.     public function onSuccess(response:Object):void    
  9.     {    
  10.         var array:Array = res as Array;  
  11.         for(var i:int = 0;i < array.length;i++){  
  12.             var user:User = User(array[i])  
  13.             trace("userName is : " + user.getUserName());  
  14.             trace("emailId is : " +  user.getEmail());  
  15.         }  
  16.     }    
  17.     public function onException(exception:App42Exception):void    
  18.     {    
  19.         trace("Exception Message " + exception);    
  20.     }    
  21. }    
Get User By Email ID

Get user details based on Email ID.

Required Parameters

emailId - Email ID of the user whose detail is to be retrieved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var emailId:String = "nick@shephertz.com";  
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.getUserByEmailId(emailId,new callback());   
  5. public class callback implements App42CallBack    
  6. {    
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var user:User = User(response);   
  10.         trace("userName is " + user.getUserName());  
  11.         trace("emailId is " + user.getEmail());  
  12.     }      
  13.     public function onException(exception:App42Exception):void    
  14.     {    
  15.         trace("Exception Message " + exception);    
  16.     }   
  17. }    
Lock User

Lock the user based on the username. Your app can use this feature to lock a user because of reasons specific to their use case. For example, if payment is not received and the app wants the user to be inactive.

Required Parameters

userName - Username that has to be locked.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.lockUser(userName,new callback());   
  5. public class callback implements App42CallBack    
  6. {    
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var user:User = User(response);  
  10.         trace("userName is " + user.getUserName());  
  11.         trace("accountLocked is " + user.isAccountLocked());  
  12.     }     
  13.     public function onException(exception:App42Exception):void    
  14.     {    
  15.         trace("Exception Message " + exception);    
  16.     }  
  17. }    
Unlock User

Unlock the previously locked user based on the username. Your app can use this feature to lock a user because of reasons specific to their use case. For example, if payment is received and the app wants the user to be active.

Required Parameters

userName - Username that you want to unlock.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.unlockUser(userName,new callback());   
  5. public class callback implements App42CallBack    
  6. {     
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var user:User = User(response);  
  10.         trace("userName is " + user.getUserName());  
  11.         trace("accountLocked is " + user.isAccountLocked());  
  12.     }    
  13.     public function onException(exception:App42Exception):void    
  14.     {    
  15.         trace("Exception Message " + exception);    
  16.     }    
  17. }    
Get Locked Users

Gets All the locked users details.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. App42API.initialize("API_KEY","SECRET_KEY");  
  2. var userService:UserService = App42API.buildUserService();   
  3. userService.getLockedUsers(new callback());    
  4. public class callback implements App42CallBack    
  5. {    
  6.     public function onSuccess(response:Object):void    
  7.     {    
  8.         var array:Array = res as Array;  
  9.         for(var i:int = 0;i < array.length;i++){  
  10.             var user:User = User(array[i])  
  11.             trace("userName is : " + user.getUserName());  
  12.             trace("emailId is : " +  user.getEmail());  
  13.         }  
  14.     }    
  15.     public function onException(exception:App42Exception):void    
  16.     {    
  17.         trace("Exception Message " + exception);    
  18.     }    
  19. }    
Get Locked Users Count

Gets the count of all the locked users.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. App42API.initialize("API_KEY","SECRET_KEY");  
  2. var userService:UserService = App42API.buildUserService();   
  3. userService.getLockedUsersCount(new callback());    
  4. public class callback implements App42CallBack    
  5. {    
  6.     public function onSuccess(response:Object):void    
  7.     {    
  8.         var app42Response:App42Response = App42Response(response);  
  9.         trace("Totalrecords is : " + app42Response.getTotalRecords());  
  10.     }    
  11.     public function onException(exception:App42Exception):void    
  12.     {    
  13.         trace("Exception Message " + exception);    
  14.     }    
  15. }    
Get Locked Users Paging

Get all the locked users details by paging.

max - Maximum number of records to be fetched. offset - From where the records are to be fetched.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var max:int = 1;  
  2. var offset:int = 0;  
  3. App42API.initialize("API_KEY","SECRET_KEY");  
  4. var userService:UserService = App42API.buildUserService();   
  5. userService.getLockedUsersWithPaging(max,offset,new callback());    
  6. public class callback implements App42CallBack    
  7. {    
  8.     public function onSuccess(response:Object):void    
  9.     {    
  10.         var array:Array = res as Array;  
  11.         for(var i:int = 0;i < array.length;i++){  
  12.             var user:User = User(array[i])  
  13.             trace("userName is : " + user.getUserName());  
  14.             trace("emailId is : " +  user.getEmail());  
  15.         }  
  16.     }    
  17.     public function onException(exception:App42Exception):void    
  18.     {    
  19.         trace("Exception Message " + exception);    
  20.     }    
  21. }    
Get User By Profile Data

Get the list of users based on profile data.

Required Parameters

profileData - Profile Data key/value for which Users need to be retrieved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
Reset User Password

Reset User password and send email with password inside.

Required Parameters

userName - Username for whom password has to be reset.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.resetAppUserPassword(userName,new callback());    
  5. public class callback implements App42CallBack    
  6. {    
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var app42Response:App42Response = App42Response(response);   
  10.         trace("response is : "+ app42Response);   
  11.     }   
  12.     public function onException(exception:App42Exception):void    
  13.     {    
  14.         trace("Exception Message " + exception);    
  15.     }     
  16. }   
Revoke Role

Revoke the specified role from the user.

Required Parameters

userName - Username whose role has to be revoked. role - Role that has to be revoked.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. var role:String  = "Admin";  
  3. App42API.initialize("API_KEY","SECRET_KEY");  
  4. var userService:UserService = App42API.buildUserService();   
  5. userService.revokeRole(userName,role,new callback());    
  6. public class callback implements App42CallBack    
  7. {   
  8.     public function onSuccess(response:Object):void    
  9.     {    
  10.         var app42Response:App42Response = App42Response(response);   
  11.         trace("response is : "+ app42Response);   
  12.     }     
  13.     public function onException(exception:App42Exception):void    
  14.     {    
  15.         trace("Exception Message " + exception);    
  16.     }    
  17. }    
Revoke All Roles

Revokes all the roles from the user.

Required Parameters

userName - Name of the user from whom Roles have to be revoked.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.revokeAllRoles(userName,new callback());    
  5. public class callback implements App42CallBack    
  6. {    
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var app42Response:App42Response = App42Response(response);   
  10.         trace("response is : "+ app42Response);   
  11.     }    
  12.     public function onException(exception:App42Exception):void    
  13.     {    
  14.         trace("Exception Message " + exception);    
  15.     }    
  16. }    
Update Email

Updates the User based on username.
Note: Only email can be updated. Username cannot be updated.

Required Parameters

userName - Username whose email ID has to updated. emailId - New email ID for the user to change.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. var emailId:String  = "nick@shephertz.com";  
  3. App42API.initialize("API_KEY","SECRET_KEY");  
  4. var userService:UserService = App42API.buildUserService();   
  5. userService.updateEmail(userName,emailId,new callback());   
  6. public class callback implements App42CallBack    
  7. {    
  8.     public function onSuccess(response:Object):void    
  9.     {    
  10.         var user:User = User(response);       
  11.         trace("userName is " + user.getUserName());  
  12.         trace("emailId is " + user.getEmail());   
  13.     }     
  14.     public function onException(exception:App42Exception):void    
  15.     {    
  16.         trace("Exception Message " + exception);  
  17.     }    
  18. }    
Delete User

Delete a particular user based on username.
Note: From this method, you can only soft delete the user. If you want to delete the user permanently, you can do so in two ways 1. Delete from AppHQ console management. 2. Set the “deletePermanent” flag true in otherMetaHeaders. See Delete User Permanent.

Required Parameters

userName - Username that you want to delete.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.deleteUser(userName,new callback());   
  5. public class callback implements App42CallBack    
  6. {    
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var app42response :App42Response is  App42Response(response);      
  10.         trace("response is " + app42response)   
  11.     }     
  12.     public function onException(exception:App42Exception):void    
  13.     {    
  14.         trace("Exception Message " + exception);    
  15.     }    
  16. }    
Logout

Invalidate the session of user based on session ID.

Required Parameters

sessionId - SessionID of the user who you want to logout.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var sessionId:String = "<Enter_the_session_id>";  
  2. App42API.initialize("API_KEY","SECRET_KEY");  
  3. var userService:UserService = App42API.buildUserService();   
  4. userService.logout(sessionId,new callback());   
  5. public class callback implements App42CallBack    
  6. {    
  7.     public function onSuccess(response:Object):void    
  8.     {    
  9.         var app42response :App42Response is  App42Response(response);      
  10.         trace("response is " + app42response)   
  11.     }     
  12.     public function onException(exception:App42Exception):void    
  13.     {    
  14.         trace("Exception Message " + exception);    
  15.     }    
  16. }    
Delete User Permanent

Delete a particular user based on username.
Note: This will delete your user permanently.

Required Parameters

userName - Username that you want to delete.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. var otherMetaHeaders:Dictionary = new Dictionary();  
  3. otherMetaHeaders["deletePermanent"] = "true";  
  4. App42API.initialize("API_KEY","SECRET_KEY");  
  5. var userService:UserService = App42API.buildUserService();   
  6. userService.setOtherMetaHeaders(otherMetaHeaders);  
  7. userService.deleteUser(userName,new callback());   
  8. public class callback implements App42CallBack    
  9. {    
  10.     public function onSuccess(response:Object):void    
  11.     {    
  12.         var app42response :App42Response is  App42Response(response);      
  13.         trace("response is " + app42response)   
  14.     }     
  15.     public function onException(exception:App42Exception):void    
  16.     {    
  17.         trace("Exception Message " + exception);    
  18.     }    
  19. }    
Authenticate With Email

Authenticate user based on Email ID and password.

Required Parameters

emailId - Email ID of the user. pwd - Password that was entered when the user created their profile.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var emailId:String = "nick@shephertz.co.in";     
  2. var pwd:String  = "*****";  
  3. var otherMetaHeaders:Dictionary = new Dictionary();  
  4. otherMetaHeaders["emailAuth"] = "true";  
  5. App42API.initialize("API_KEY","SECRET_KEY");  
  6. var userService:UserService = App42API.buildUserService();   
  7. userService.setOtherMetaHeaders(otherMetaHeaders);  
  8. userService.authenticate(emailId,pwd, new callback());    
  9. public class callback implements App42CallBack    
  10. {    
  11.     public function onSuccess(response:Object):void    
  12.     {    
  13.         var user:User = User(response);  
  14.         trace("userName is " + user.getUserName());  
  15.         trace("sessionId is " + user.getSessionId());  
  16.     }    
  17.     public function onException(exception:App42Exception):void    
  18.     {    
  19.         trace("Exception Message " + exception);    
  20.     }    
  21. }  
Saving Additional Data along with User

Save additional data of user while creating a new user. One can fetch this saved information back by getting user. See Fetch Additional data of User .

Required Parameters

collectionName - Name of collection under which JSON doc needs to be saved. jsonDoc - Target JSON document to be saved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";     
  2. var pwd:String  = "*****";  
  3. var emailId:String = "nick@shephertz.co.in";  
  4. var dbName:String = "<Your_DataBase_Name>";  
  5. var collectionName:String = "<Your_Collection_Name>";   
  6. var jsonDoc:Object = new Object;  
  7. jsonDoc.name = "John";  
  8. jsonDoc.age = 30;  
  9. App42API.setDbName(dbName);  
  10. App42API.initialize("API_KEY","SECRET_KEY");  
  11. var userService:UserService = App42API.buildUserService();   
  12. userService.addJSONObject( collectionName, jsonDoc);  
  13. userService.createUser(userName,pwd,emailId, new callback());    
  14. public class callback implements App42CallBack    
  15. {    
  16.     public function onSuccess(response:Object):void    
  17.     {    
  18.         var user:User = User(response);   
  19.         var jsonDoc:JSONDocument = new JSONDocument();   
  20.         trace("userName is " + user.getUserName());  
  21.         trace("emailId is " + user.getEmail());  
  22.         var jsonDocsList:Array = user.getJsonDocList();  
  23.         for(var t:int=0; t < jsonDocsList.length;t++)  
  24.         {  
  25.             jsonDoc = JSONDocument(jsonDocsList[t]);  
  26.             trace("Doc ID is in get user : : "+ jsonDoc.getDocId());  
  27.             trace("CreatedAt is : " + jsonDoc.getCreatedAt());  
  28.             trace("UpdatedAt is :  " + jsonDoc.getUpdatedAt());  
  29.             trace("JsonDoc is :  " + jsonDoc.getJsonDoc());       
  30.         }  
  31.     }    
  32.     public function onException(exception:App42Exception):void    
  33.     {    
  34.         trace("Exception Message " + exception);    
  35.     }    
  36. }    
Fetch Additional data of User

Fetches additional data of user in JSON format. One can pass query object while fetching desired records of user. Null value of query object will return all records of user in given collection.

Required Parameters

userName - Name of the user whose data is to be retrieved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";    
  2. var key1:String = "name";  
  3. var value1:String = "John";  
  4. App42API.setDbName("<Enter_the_dbName>");  
  5. var query:Query = QueryBuilder.build(key1, value1, Operator.EQUALS);  
  6. App42API.initialize("API_KEY","SECRET_KEY");  
  7. var userService:UserService = App42API.buildUserService();   
  8. userService.setQuery( "<Your_Collection_Name>", query);  
  9. userService.getUser(userName, new callback());   
  10. public class callback implements App42CallBack    
  11. {    
  12.     public function onSuccess(response:Object):void    
  13.     {    
  14.         var user:User = User(response);   
  15.         var jsonDoc:JSONDocument = new JSONDocument();   
  16.         trace("userName is " + user.getUserName());  
  17.         trace("emailId is " + user.getEmail());  
  18.         var jsonDocsList:Array = user.getJsonDocList();  
  19.         for(var t:int=0; t < jsonDocsList.length;t++)  
  20.         {  
  21.             jsonDoc = JSONDocument(jsonDocsList[t]);  
  22.             trace("Doc ID is in get user : : "+ jsonDoc.getDocId());  
  23.             trace("CreatedAt is : " + jsonDoc.getCreatedAt());  
  24.             trace("UpdatedAt is :  " + jsonDoc.getUpdatedAt());  
  25.             trace("JsonDoc is :  " + jsonDoc.getJsonDoc());       
  26.         }  
  27.     }    
  28.     public function onException(exception:App42Exception):void    
  29.     {    
  30.         trace("Exception Message " + exception);    
  31.     }    
  32. }    
Create User With Profile

This function allows you to create a user session for the specified User and add their profile.
Note: Username and Email ID should be unique for the App.

Required Parameters

userName - Name of the user whose user session is to be created. pwd - Password of the user. emailId - Email ID of the user. profile - Add all the values that you want to retain in user profile object.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";   
  2. var pwd:String  = "*****";  
  3. var emailId:String = "nick@shephertz.co.in";  
  4. var date:Date = new Date();   
  5. var profile:Profile  =new Profile();  
  6. profile.setFirstName("Nick");  
  7. profile.setLastName("Gill");  
  8. profile.setSex(UserGender.MALE);  
  9. profile.setDateOfBirth(date);  
  10. profile.setCity("Houston");  
  11. profile.setState("Texas");  
  12. profile.setPincode("74193");  
  13. profile.setCountry("USA");  
  14. profile.setMobile("+1-1111-111-111");  
  15. profile.setHomeLandLine("+1-2222-222-222");  
  16. profile.setOfficeLandLine("+1-33333-333-333");  
  17. App42API.initialize("API_KEY","SECRET_KEY");  
  18. var userService:UserService = App42API.buildUserService();   
  19. userService.createUserWithProfile(userName,pwd,emailId,profile,new callback());  
  20. public class callback implements App42CallBack  {    
  21.     public function onException(excption:App42Exception):void    
  22.     {    
  23.         trace("Exception Message"+ excption.getMessage());    
  24.     }    
  25.     public function onSuccess(response:Object):void    
  26.     {    
  27.             var user:User = User(response);  
  28.             trace("User Name :"+user.getUserName());          
  29.             trace("Email Id:"+user.getEmail());  
  30.             trace("First Name is :"+user.getProfile().getFirstName());  
  31.             trace("City is :"+user.getProfile().getCity());  
  32.             trace("Country is :"+user.getProfile().getCountry());  
  33.     }    
  34. }  
Get Users By Group

This function allows you to find the list of user data.

Required Parameters

userList - List of user for whom you want to find the data.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userList:Array = new Array();  
  2. userList.push("Username");  
  3. App42API.initialize("API_KEY","SECRET_KEY");  
  4. var userService:UserService = App42API.buildUserService();   
  5. userService.getUsersByGroup(userList,new callback());  
  6. public class callback implements App42CallBack  {    
  7.     public function onException(excption:App42Exception):void    
  8.     {    
  9.         trace("Exception Message"+ excption.getMessage());    
  10.     }    
  11.     public function onSuccess(response:Object):void    
  12.     {    
  13.         for(var i:int = 0;i < response.length;i++){  
  14.             var user:User = User(response[i])  
  15.         trace("User Name :"+user.getUserName());          
  16.         trace("Email Id:"+user.getEmail());  
  17.         trace("First Name is :"+user.getProfile().getFirstName());  
  18.         trace("City is :"+user.getProfile().getCity());  
  19.         trace("Country is :"+user.getProfile().getCountry());  
  20.         }  
  21.     }    
  22. }  
Reset User Password With Custom Name

Set your custom name while resetting the user password in email template.
Note: This method works only if you created email template from AppHQ Console.

Required Parameters

userName - Username for whom password has to be reset.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. var otherMetaHeaders:Dictionary = new Dictionary();  
  3. otherMetaHeaders["customName"] = "John";  
  4. App42API.initialize("API_KEY","SECRET_KEY");  
  5. var userService:UserService = App42API.buildUserService();   
  6. userService.setOtherMetaHeaders(otherMetaHeaders);  
  7. userService.resetAppUserPassword(userName,new callback());    
  8. public class callback implements App42CallBack    
  9. {    
  10.     public function onSuccess(response:Object):void    
  11.     {    
  12.         var app42Response:App42Response = App42Response(response);   
  13.         trace("response is : "+ app42Response);   
  14.     }   
  15.     public function onException(exception:App42Exception):void    
  16.     {    
  17.         trace("Exception Message " + exception);    
  18.     }     
  19. }   
Reset User Password With Email Verification

Send the verification link for resetting the app user password.
Note: This method works Only if you created email template from AppHQ Console.

Required Parameters

userName - Username for whom password has to be reset.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. var otherMetaHeaders:Dictionary = new Dictionary();  
  3. otherMetaHeaders["emailVerification"] = "true";  
  4. App42API.initialize("API_KEY","SECRET_KEY");  
  5. var userService:UserService = App42API.buildUserService();   
  6. userService.setOtherMetaHeaders(otherMetaHeaders);  
  7. userService.resetAppUserPassword(userName,new callback());    
  8. public class callback implements App42CallBack    
  9. {    
  10.     public function onSuccess(response:Object):void    
  11.     {    
  12.         var app42Response:App42Response = App42Response(response);   
  13.         trace("response is : "+ app42Response);   
  14.     }   
  15.     public function onException(exception:App42Exception):void    
  16.     {    
  17.         trace("Exception Message " + exception);    
  18.     }     
  19. }   
Get Profile With Authenticate

Fetch the user profile along with user authentication.

Required Parameters

userName - Username that you want to authenticate. pwd - Password that was entered when you created the user.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";      
  2. var pwd:String  = "*****";  
  3. var otherMetaHeaders:Dictionary = new Dictionary();  
  4. otherMetaHeaders["userProfile"] = "true";  
  5. App42API.initialize("API_KEY","SECRET_KEY");  
  6. var userService:UserService = App42API.buildUserService();   
  7. userService.setOtherMetaHeaders(otherMetaHeaders);  
  8. userService.authenticate(userName,pwd, new callback());    
  9. public class callback implements App42CallBack    
  10. {    
  11.     public function onSuccess(response:Object):void    
  12.     {    
  13.         var user:User = User(response);  
  14.         trace("userName is " + user.getUserName());  
  15.         trace("sessionId is " + user.getSessionId());  
  16.     }    
  17.     public function onException(exception:App42Exception):void    
  18.     {    
  19.         trace("Exception Message " + exception);    
  20.     }    
  21. }  
Get Users By Profile Data With Specific Data

Fetch all the list of users who has a specific value in their profile e.g If you want to fetch the list of users whose first name start from “Nick” and last name start from “Gill” using below code snippet.

Required Parameters

profileData - Profile Data key/value for which Users need to be retrieved.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
Exception Handling

The functions available under User API can throw some exceptions in abnormal conditions. For example, If a developer is creating a user with a username which is already in the database, the function will throw the App42Exception (as shown below) with the message as “Bad Request” and the appErrorCode as “2001” and the details as “The request parameters are invalid. Username ‘Nick’ already exists”.

  • create User Api for Android
  • create User Api for Windows
  • create User Api for iOS
  • create User Api for Swift
  • create User Api for Java
  • create User Api for Unity
  • create User Api for JS
  • create User Api for Corona
  • create User Api for Cocos2DX
  • create User Api for .Net
  • create User Api for PHP
  • create User Api for Marmalade
  •  create User Api for Ruby
  •  create User Api for Flash
  1. var userName:String = "Nick";  
  2. var pwd:String = "********";  
  3. var emailId:String = "nick@shephertz.co.in";  
  4. App42API.initialize("API_KEY","SECRET_KEY");  
  5. var userService:UserService = App42API.buildUserService();   
  6. userService.createUser(userName, pwd, emailId,new callback());   
  7. public class callback implements App42CallBack    
  8. {     
  9.     public function onSuccess(response:Object):void    
  10.     {    
  11.         var user :User= User(response);      
  12.         trace("user is " + user)   
  13.     }    
  14.     public function onException(exception:App42Exception):void    
  15.     {    
  16.         var appErrorCode:int = exception.getAppErrorCode();    
  17.         var httpErrorCode:int = exception.getHttpErrorCode();    
  18.         if(appErrorCode == 2001)  
  19.         {  
  20.             // Handle here for Bad Request (The request parameters are invalid. Username 'Nick' already exists.)  
  21.         }  
  22.         else if(appErrorCode  == 2005)  
  23.         {  
  24.             // Handle here for Bad Request (The request parameters are invalid. User with emailId 'nick@shephertz.co.in' already exists.)  
  25.         }  
  26.         else if(appErrorCode == 1401)  
  27.         {  
  28.             // handle here for Client is not authorized  
  29.         }  
  30.         else if(appErrorCode == 1500)  
  31.         {  
  32.             // handle here for Internal Server Error  
  33.         }  
  34.     }     
  35. }    
Error Codes

Functions in User API might throw exceptions with following HTTP and Application Error Codes (along with their descriptions):

1400 - BAD REQUEST - The requested parameters are invalid 1401 - UNAUTHORIZED - Client is not authorized. 1500 - INTERNAL SERVER ERROR - Internal Server Error. Please try again 2000 - NOT FOUND - User by the name '@userName' does not exist. 2001 - BAD REQUEST - The request parameters are invalid. Username '@userName' already exists. 2002 - NOT FOUND - UserName/Password did not match. Authentication Failed. 2003 - BAD REQUEST - Old Password is not matching for user '@userName'. 2004 - NOT FOUND - User with the emailId '@emailId' does not exist. 2005 - BAD REQUEST - The request parameters are invalid. User with emailId '@emailId' already exists. 2006 - NOT FOUND - Users do not exist. 2007 - NOT FOUND - The number of users are less than the specified offset 2008 - NOT FOUND - The number of locked users are less than the specified offset 2009 - NOT FOUND - Users with the role '@role' do not exist. 2010 - NOT FOUND - No role found for the user '@userName'. 2011 - NOT FOUND - Role '@role' for the user '@userName' does not exist. 2012 - NOT FOUND - Roles for the user '@userName' do not exist.