MAPI Manual

NAME

GET_DEVICE_LOGINNAME

FUNCTION

Get user's login name by device ID

SYNOPSIS

action: GET_DEVICE_LOGINNAME
device_id

DESCRIPTION

This function allows users to get their login name by device ID. If the device has already been logged into the system, users can use device ID to get their login name. Both GET and POST methods can be used to perform the request.

Required Parameters

* action: specifies the requested function. Sets to GET_DEVICE_LOGINNAME.
* 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 attributes:
* org_id: ID of the organization to which the user belongs.
* login_name: login name of the user.

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

ROLE PERMITTED

All roles

EXAMPLES

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

Request:
http://app02.yvntech.com/MapIHttpS/MapIS?action=GET_DEVICE_LOGINNAME&device_id=mytestid

Response:
<result tftype='1' infotype='0'>
    <field name='org_id'>10000</field>
    <field name='login_name'>name@example.com</field>
</result>

TIPS

ENVIRONMENT

AUTHOR

YVN Tech

SEE ALSO

LOGIN, CHECKIN

Mweb v2.0 YVNTECH 2014