If you want to access the Windows Live custom domains Web ServiceCode, You need to look at the following methods in the pipeline.
Getloginurl
Public String getloginurl (string membername)
Call: getloginurl (fanweixiao@hotmail.com)
Return: to use the passport login URL of our service
Getlogindatatemplate
Public String getlogindatatemplate ()
Obtain the data template used to obtain the passport authentication ticket (passport authentication ticket ).
Note: after this method is called, we must use the domain administrator's login name and password to replace the values in the template and then call passport, because this template will not change, we only need to call it once in each session.
Verifyauthdata
Public bool verifyauthdata (string authdata)
Send the modified data returned by the getlogindatatemplate () method to the URL returned by getloginurl () to verify the login user. If it is a valid domain administrator, the system returns true.
The above three methods can be used to create a passport ticket. We only need to log on once, and then we can directly add, delete, import, and discard (evict) operations. The ticket expires at least one hour.
Adduser
Public void adduser (string name, string password, bool resetpassword, string authdata)
It should be noted that if the name is the vc@onlyvc.org style, the password is used to log on to Hotmail. If resetpassword is true, the new user needs to change the password when logging on to Hotmail for the first time.
Note that before calling this method, you must call the getuserstate method in the western region to determine whether the user name can be added.
Getuserstate
Public Enum getuserstate (string name, string authdata)
Returns the status of the user corresponding to the user name. Its return values are as follows:
0: Indicates valid and can be registered.
1: The user name is blocked and contains invalid characters.
2: The user has been registered.
3: the user was a passport account and wanted to bind it to the Hotmail inbox. The account was deleted in the past 30 days. Based on the Hotmail mechanism, these accounts cannot be applied again within 30 days. This often occurs when an offline message inbox (OIM inbox, offline Instant Messenger) where a user name has used messenger, OIM uses Hotmail to store offline messages, this feature is widely used by new messenger live services.
4: the easi account already exists (Easi has been introduced in the previous article ). If you want to create a new account, you can discard it first.
Deleteuser
Public void deleteuser (string name, string authdata)
This method should be used with caution, because the deleted user will not only lose all emails, but also be banned for 30 days before being used again. During the next login, the user will be notified of the need to modify the passport account name, which has nothing to do with our domain.
Enumusers
Public String [] enumusers (string domainname, string start, int num, string authdata)
Start indicates the start value of the returned list. If it is "", all user names are returned, which are saved as string arrays. Num indicates the number of returned results. The maximum allowed value is 500, therefore, if the value is greater than 500, all users can be returned.
Importuser
Public void importuser (string name, string authdata)
Import a user registered on passport. Refer to the description of the previous blog to learn the purpose of this method. This method may fail to be called as follows:
- The user does not exist in passport.
- The user is within the management scope of the domain (it has been imported or added)
Evictsquatter
Public void evictsquatter (string name, string authdata)
It is also related to the previous blog, which may also fail for the same reason as importuser.
Enumdomains
Public domainstate [] enumdomains (string authdata)
All Domain Information managed by this administrator is returned.
Domainstate [] consists of the following three parts:
- Domain Name (string)
- Active State activity status (Boolean)
- MX record (string)
If a domain name has multiple administrators, the MX record displays the settings set by the login user.
Getdomainstate
Public domainstate [] getdomainstate (string domainname, string authdata)
Obtain the status information of a domain. The composition of domainstate [] is the same as that
To be continued...