Table of contents
TOC
Свернуть оглавление
Развернуть оглавление
Последнее обновление: 20.06.2018

Общие задачи обнаружения конечных точек с использованием API службы обнаружения

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

Функциональность API Office 365 также доступна с использованием Microsoft Graph — унифицированного API, который включает в себя API других служб Майкрософт, таких как Outlook, OneDrive, OneNote, Планировщик и Office Graph, доступных через единую конечную точку и с одним маркером доступа. Мы рекомендуем использовать Microsoft Graph в ваших приложениях, когда это возможно.

API Office 365 обеспечивают доступ к событиям, контактам, почте и файлам через службы Microsoft. Перед тем как пользователи вашего приложения смогут получить доступ к службам и пользовательским ресурсам Microsoft, приложение нуждается в конечных точках. Служба обнаружения позволяет динамически обнаруживать эти конечные точки и получать информацию, необходимую для получения доступа.

Служба обнаружения предоставляет RESTful API. Клиентские SDK доступны для Платформа .NET, Android, а также IOS. Служба обнаружения поддерживает обнаружение Календаря, Контактов, Почты, Моих файлов (для конечных точек обслуживания OneDrive и OneDrive for Business), Заметок (для OneNote) и RootSite (для SharePoint).

Заметка Служба обнаружения предоставляет только функциональные возможности для онлайн-среды Office 365 и не работает для локальных развертываний.

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

URI конечной точки API для службы обнаружения выглядит следующим образом.

Версия v1.0:

ApiEndpoint = "https://api.office.com/discovery/v1.0/me/;

Версия v2.0:

ApiEndpoint = "https://api.office.com/discovery/v2.0/me/;

Идентификатор ресурса для службы обнаружения:

ResourceId = "https://api.office.com/discovery/";

Требования к службе обнаружения

Перед использованием Службы обнаружения вам необходимо Настроить среду разработки Office 365.

Процесс Службы обнаружения

Ниже приведен рабочий процесс для приложения, использующего службу обнаружения.

Таблица 1. Взаимодействие между вашим приложением, службой обнаружения и Azure AD для вызова Office 365 API

ЭтапОписаниеРабочий процесс
1Зарегистрируйте свое приложение на портале управления Azure и настройте код приложения с идентификатором клиента и переадресацией URI. Затем на портале управления Azure настройте разрешения для приложения.
2Ваше приложение получает адрес электронной почты пользователя. Он связывается с службой обнаружения с адресом электронной почты и набором областей, к которым приложение хочет получить доступ.Ваше приложение запрашивает код авторизации для службы обнаружения.
3Приложение отправляется на конечную точку авторизации AD Azure, и пользователь аутентифицирует и предоставляет согласие (если согласие ранее не было предоставлено). Azure AD выдает код авторизации.Пользователь проходит аутентификацию и дает подтверждение. Azure AD выдает код авторизации.
4Ваше приложение выдает код авторизации. Azure возвращает маркер доступа и маркер обновления.Ваше приложение выдает код авторизации. Azure возвращает токен доступа и токен обновления.
5Ваше приложение вызывает службу обнаружения с использованием маркера доступа. Служба обнаружения возвращает Http ответ с идентификаторами ресурсов и URI конечных точек для служб Office 365.Ваше приложение вызывает службу обнаружения с использованием токена доступа. Служба обнаружения возвращает Http ответ с идентификаторами ресурсов и URI конечных точек для служб Office 365.
6Ваше приложение выдает токен обновления с конечной точкой маркера Azure AD, чтобы получить токен доступа для нужного ресурса Office 365. Конечная точка маркера Azure AD возвращает токен доступа для указанного ресурса и токена обновления.Ваше приложение выдает токен обновления с конечной точкой маркера Azure AD, чтобы получить токен доступа для нужного ресурса Office 365. Конечная точка маркера Azure AD возвращает маркер доступа и маркер обновления.
7Теперь приложение может вызывать интерфейсы API Office 365 с помощью кода URI из службы обнаружения и маркера доступа. Office 365 возвращает Http ответ.Теперь приложение может вызывать интерфейсы API Office 365 с помощью кода URI из службы обнаружения и маркера доступа.

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

Для получения информации об API, которые использует Служба обнаружения, см. Справочник по операциям REST API службы обнаружения.

Дополнительные ресурсы

© 2018 Microsoft