MAPI Manual

NAME

SET_USER_LOCATION_AND_TIMEZONE

FUNCTION

User set location and timezone

SYNOPSIS

action: SET_USER_LOCATION_AND_TIMEZONE
mcp_location_id
tz_abbr

login_name
login_passwd
or
login_name
session_id
or
device_id

DESCRIPTION

This function allows users to set their location and time zone. Both GET and POST methods can be used to perform the request.

Required Parameters
* action: specifies the requested function. Sets to SET_USER_LOCATION_AND_TIMEZONE.
* mcp_location_id: the location ID.
* tz_abbr: the time zone abbreviation.

* login_name: the login name for authenticating the user.
* login_passwd: the login password for authenticating the user.
or
* login_name: the login name for authenticating the user.
* session_id: the session ID for authenticating the user.
or
* device_id: a unique ID of the device. The system can use it as a key to identify users.

RETURN DATA

For each valid request, the server provides a response in XML format, wrapped within a <result> tag.
The response contains the following attribute:
* msg: a string indicating the user's location and time zone have been set successfully.

For an invalid request, the response XML contains the following attribute:
* msg: a string containing the error message.

ROLE PERMITTED

manager

EXAMPLES

The following example shows a successful HTTP GET request and response.

Request:
http://app02.yvntech.com/MapIHttpS/MapIS?action=SET_USER_LOCATION_AND_TIMEZONE&mcp_location_id=61&tz_abbr=TZ89&device_id=testid

Response:
<result tftype='1' infotype='0'>
    <field name='msg'>SUCCESS</field>
</result>

TIPS

ENVIRONMENT

AUTHOR

YVN Tech

SEE ALSO

LIST_LOCATIONS, LIST_TIMEZONES

Mweb v2.0 YVNTECH 2014