Changes between Version 80 and Version 81 of XMLRPC


Ignore:
Timestamp:
May 8, 2015, 3:09:28 PM (10 years ago)
Author:
os
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • XMLRPC

    v80 v81  
    8585== !LogIn ==
    8686'''array !LogIn( $username, $password, $language, $useragent )'''
    87 This will login user. This function should be called always when starting talking with server. It returns '''token''', which must be used in later communication. If user has no account, blank username and password should be OK. As language - use [http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes ISO639] 2 letter code and later communication will be done in this language if applicable (error codes and so on). Note: when username and password is blank, status is 200 OK, because we want allow anonymous users too. Useragent cannot be empty string. For $useragent use your [wiki:DevReadFirst registered useragent], also provide version number - we need tracking version numbers of your program. If your UA is not registered, you will get error '''414 Unknown User Agent'''.
     87This will login user. This function should be called always when starting talking with server. It returns '''token''', which must be used in later communication. If user has no account, blank username and password should be OK. As language - use [http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes ISO639] 2 letter code and later communication will be done in this language if applicable. You can also pass language in HTTP ACCEPT-LANGUAGE header. Note: when username and password is blank, status is 200 OK, because we want allow anonymous users too. Useragent cannot be empty string. For $useragent use your [wiki:DevReadFirst registered useragent], also provide version number - we need tracking version numbers of your program. If your UA is not registered, you will get error '''414 Unknown User Agent'''.
     88
     89Important: for security improvement, you can use HTTPS and/or send $password as MD5($password) hash.
    8890
    8991Note: don't send any cookies using XML-RPC, specially cookie named "PHPSESSID=" can cause unpredictable behaviour while Loggin In.