Ссылка на REST API службы обнаружения

Область применения: Office 365

Использование службы обнаружения Office 365

Чтобы взаимодействовать с API службы обнаружения, вы отправляете запросы HTTP и OData. Служба обнаружения поддерживает обнаружение Календаря, Контактов, Почты, MyFiles (для конечных точек обслуживания OneDrive и OneDrive для бизнеса), Заметок (для OneNote) и RootSite (для SharePoint).

ИД ресурса для службы обнаружения: ResourceId = https://api.office.com/discovery/.

Для примеров кода того, как использовать API службы обнаружения для поиска конечных точек для служб, к которым вы обращаетесь с использованием API Office 365, см. API Office 365: использование службы обнаружения и Пример службы обнаружения Office 365.

Управление версиями

Ниже приведены версии службы обнаружения.

Операции службы обнаружения

Первоначальный вход в систему

Это приводит клиента к веб-странице, где пользователь вводит данные учетной записи. Она возвращает конечные точки, необходимые для продолжения работы со службой обнаружения. Это используется при первом запуске приложения пользователем.

Он сообщает вашему приложению:

1. К какому облаку принадлежит пользователь
2. Куда приложение может отправить пользователя для входа в систему
3. Где можно получить маркер

Пример

var firstSignInUri = new Uri(string.Format("https://api.office.com/discovery/v1.0/me/FirstSignIn?redirect_uri={0}&scope={1}", TerminalUriText, Scope));
var terminalUri = new Uri(TerminalUriText);

//Starting authorization
var webAuthResult = await WebAuthenticationBroker.AuthenticateAsync(WebAuthenticationOptions.None, firstSignInUri, terminalUri)
   .AsTask().ConfigureAwait(continueOnCapturedContext: true);

//Authorization finished
If (webAuthResult.ResponseStatus == WebAuthenticationStatus.Success)
{
var userEmail = MyExtractParamter("user_email",webAuthResult.ResponseData);
var accountType = MyExtractParamter("account_type",webAuthResult.ResponseData);
var authorizationService = MyExtractParamter("authorization_service",webAuthResult.ResponseData);
var tokenService = MyExtractParamter("token_service", webAuthResult.ResponseData);
var discoveryService = MyExtractParamter("discovery_service", webAuthResult.ResponseData);
var scope = MyExtractParamter("scope",webAuthResult.ResponseData);
var unsupportedScope = MyExtractParamter("unsupported_scope", webAuthResult.ResponseData);

MyCacheUserInfo(...);
}

Узнайте о конкретных службах

Используйте /службы API для получения конечной точки конкретной службы.

Пример

var url = string.Format("https://api.office.com/discovery/v1.0/me/services", discoveryService);

var request = HttpWebRequest.CreateHttp(url);
request.Method = "GET";
request.Headers["Authorization"] = "Bearer " + accessToken;

var response = await request.GetResponseAsync().ConfigureAwait(continueOnCapturedContext: true) as HttpWebResponse;

Узнайте, какие службы можно обнаружить

Используйте AllServices API, чтобы узнать о всех возможностях, доступных для обнаружения, а также службах, которые их реализуют. /AllServices принимает анонимные запросы и, следовательно, не требует маркера доступа.

Пример

var request = HttpWebRequest.CreateHttp("https://api.office.com/discovery/v1.0/me/services");
request.Method = "GET";
request.Headers["Accept"] = "application/json;odata=verbose";

var response = await request.GetResponseAsync().ConfigureAwait(continueOnCapturedContext: true) as HttpWebResponse;

Схема ServiceInfo

API-интерфейсы /services API и /allservices API используют записи ServiceInfo в своем тексте ответа.

См. также

• Обзор разработки на платформе Office 365
• Используйте API службы обнаружения для поиска конечных точек для вашего приложения Office 365
• API Office 365: использование службы обнаружения