API Reference


User methods allow you display, create, remove and manipulate user accounts within Media Factory.
Users.confirmCredentials

Confirms a users username and password, and optionally returns user information.

If returnUserInfo is set to false, this method will return the user id when the settings were correct. This method always returns false when username or password is incorrect.

If login is set to true a session will be started and the system will return a sessiontoken property in the userData struct. read more »

Users.getUserInfoByExternalID

This method returns all available information about a requested user based on an exernal user ID. The method requires an external user ID and vhost.

read more »
Users.getUserInfoByPhone
This method returns all available user information about a specific user based on the required phone number . This method requires a valid phone number and a vhost ID. read more »
Users.registerOrUpdate

This method registers a new user or updates an existing user if it already exists and returns the user's ID.

The userData is optional, and can be used to update user information if needed. The "userName" parameter will be used as the primary key here. The username may not be updated through this service call; it will only be used if a new user is being registered.

The "userName" read more »

Users.reportOffensive

This function marks a particular user as offensive.

Note: A user can report a user as offensive once.

You can pass various optional parameters to this function, including the id of the user who reported the user as offensive and the reason why the user was reported offensive. If you wish to send an email to a particular person upon the use of this function, then you have to set the read more »

Users.updateUserInfo

Updates a user's information personal information and metadata.

The meta data field is a bit special. The meta field must be supplied as an array. The new user meta-data will be a merge of the existing meta-date + the newly supplied metadata. Only the top-level elements in the array will be merged, if you have an array within an array, the old top-level array will be completely read more »

Users.verifyUserEmail

Verifies if a username or email already exists in a specific vhost.

When they don't exist this method will return 1, if the user already exists it will return -1, if the email already exists it will return -2.

read more »