Home > Development
Developer Reference


Home : Developer Reference
AOS Login API commands - RFC
Home : Developer Reference : AOS API Document : Login

Date: 21 Sep. 2000
Available: 21 Oct. 2000
Status: Draft
Compliant to AOS API Version: AOS 2.0b1
Revision: 1 (4 Jan. 2001)
Web: http://www.afteroffice.com/dev/api/login.html
By fui@afteroffice.com


Description

Information on implementing different login method - from browsers and DA.


Command: st.login.mms
Use: Login as valid VO user.
Access: HTTP
Method: POST and GET
Parameters case sensitive: NO, except for password

Standard Method:
http://afteroffice.com/st.login.mms?host=domain.com&name=userName&pswd=Password&api=lc

Note: The above standard method URL login mainly use on browser.

    Parameter:

    host = [optional] the user host - usually the second part of the email (firstPart@secondPart.com). If this parameter voided, the "name" should be in the full VO POP3 ID - which carry a host prefix
    name = the user login name - usually the first part of the email (firstPart@host.com)
    pswd = the user password
    api = [optional] if "lc" is specified, the user session ID will be returned. Or else the full html will be returned.
    lang = [optional] the language interface
    timezone = [optional] the time zone.

Encrytion Method:
Alternative "eyes encryption" format can be used for Local Client or DA:
http://afteroffice.com/st.login.mms?id=specialID&api=[api]&timezone=[tz]&lang=[languge]

    Parameter:

    api = [optional] if "lc" is specified, the return result will be the user session ID.
    lang = [optional] the language interface
    timezone = [optional] the time zone.
    specialID = is a code embedded with user host, name and password. Format:

      userName|userHost|password
      Encode in base64.

    Example:
    User email: liangtyan@lookafter.com, password "abc"
    The original ID will be:
    liangtyan|lookafter.com|abc
    After base64 encoded:
    bGlhbmd0eWFufGxvb2thZnRlci5jb218YWJj

    The final URL
    http://afteroffice.com/st.login.mms?id=bGlhbmd0eWFufGxvb2thZnRlci5jb218YWJj

    MetaTalk Sample:
    put username &"|"& userhost &"|"& userPassword into theID
    put base64Encode(theID) into theID