2.2.2.1 Autodiscover
The Autodiscover command facilitates the discovery of core account configuration information by using the user's Simple Mail Transfer Protocol (SMTP) address as the primary input. For information about the Autodiscover service, see [MSFT-AUTODISCOVER]. For more details about the Autodiscover HTTP Service, see [MS-OXDSCLI].
The Autodiscover command request and response messages are sent in XML format, not WBXML format.
When sending an Autodiscover command request, the Content-Type header value MUST be set to text/xml.<1> For more details about the Content-Type header, see [MS-ASHTTP] section 2.2.1.1.2.2.
The client SHOULD use the Autodiscover command as an initial response to common HTTP errors. Common HTTP errors are specified in [MS-ASHTTP] section 2.2.2.1.1. Autodiscover has the ability to retrieve an updated URL when a mailbox has been moved, a user is trying to connect to a server that cannot access the user's mailbox, or when there is a more efficient server to use to reach the user's mailbox.
After a successful Autodiscover command response, the client sends an HTTP Options command to the server identified in the Autodiscover command response. The HTTP Options command returns the newly supported protocol versions and commands if they changed due to the Autodiscover command.
The http://schemas.microsoft.com/exchange/autodiscover/mobilesync/requestschema/2006 namespace is the primary namespace for the Autodiscover command and this section of the specification. Elements referenced in this section that are not defined in the http://schemas.microsoft.com/exchange/autodiscover/mobilesync/requestschema/2006 namespace use the namespace prefixes defined in section 2.2.1.
The following table lists the elements that are used in Autodiscover command requests and responses.
|
Element name |
Scope |
Reference |
|
Autodiscover |
Request and Response |
section 2.2.3.15 |
|
Request |
Request |
section 2.2.3.137.1 |
|
EMailAddress |
Request and Response |
section 2.2.3.52 |
|
AcceptableResponseSchema |
Request |
section 2.2.3.1 |
|
Response |
Response |
section 2.2.3.140.1 |
|
Culture |
Response |
section 2.2.3.38 |
|
User |
Response |
section 2.2.3.173 |
|
DisplayName |
Response |
section 2.2.3.47.1 |
|
Action |
Response |
section 2.2.3.6 |
|
Redirect |
Response |
section 2.2.3.134 |
|
Settings |
Response |
section 2.2.3.153.1 |
|
Server |
Response |
section 2.2.3.149 |
|
Type |
Response |
section 2.2.3.170.1 |
|
Url |
Response |
section 2.2.3.172 |
|
Name |
Response |
section 2.2.3.110.1 |
|
ServerData |
Response |
section 2.2.3.150 |
|
Error |
Response |
section 2.2.3.60 |
|
Status |
Response |
section 2.2.3.162.1 |
|
Message |
Response |
section 2.2.3.98 |
|
DebugData |
Response |
section 2.2.3.40 |
|
ErrorCode |
Response |
section 2.2.3.61 |
