Table of contents
TOC
Collapse the table of content
Expand the table of content
Última actualización: 20/06/2018

Tareas comunes de descubrimiento de puntos de conexión con la API de Servicio de detección

Se aplica a: Office 365

La funcionalidad API de Office 365 también está disponible a través de Microsoft Graph, una API unificada que incluye diferentes API de otros servicios de Microsoft como Outlook, OneDrive, OneNote, Planner y Office Graph. Es accesible a través de un solo punto de conexión y con un solo token de acceso. Recomendamos usar Microsoft Graph en las aplicaciones cuando sea posible.

Las API de Office 365 proporcionan acceso a eventos, contactos, correo y archivos a través de los servicios de Microsoft. Para que los usuarios de su aplicación puedan acceder a los servicios de Microsoft y a los recursos de los usuarios, primero la aplicación necesita sus puntos de conexión. El Servicio de detección le permite descubrir dinámicamente estos puntos de conexión y ver la información necesaria para obtener acceso.

El Servicio de detección expone una API RESTful. Los SDK de cliente están disponibles para plataforma .NET, Android e iOS. El Servicio de detección admite el descubrimiento de Calendario, Contactos, Correo, Mis archivos (para puntos finales de conexión de los servicios OneDrive y OneDrive for Business), Notas (para OneNote) y RootSite (para SharePoint).

Nota El Servicio de detección solo proporciona funcionalidad para el entorno en línea de Office 365 y no funciona para implementaciones locales.

Para obtener más información sobre las operaciones del Servicio de detección, consulte Referencia de operaciones API REST del Servicio de detección. Para ejemplos de código sobre cómo usar la API del Servicio de detección para buscar puntos de conexión para los servicios a los que accede utilizando las API de Office 365, consulte API de Office 365: cómo usar el Servicio de detección y Ejemplo del Servicio de detección de Office 365.

El URI del punto de conexión de API para el Servicio de detección es el siguiente.

Versión 1.0:

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

Versión 2.0:

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

El ID de recurso para el Servicio de detección:

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

Requisitos del Servicio de detección

Para usar el Servicio de detección, primero debe Configurar su entorno de desarrollo de Office 365.

Proceso del Servicio de detección

A continuación se muestra el flujo de trabajo de una aplicación que usa el Servicio de detección.

Tabla 1. Interacciones entre su aplicación, el Servicio de detección y Azure AD para llamar a las API de Office 365

PasoDescripciónFlujo de trabajo
1Registre su aplicación en el Portal de administración de Azure y configure el código de la aplicación con el Id. del cliente y el URI de redirección. A continuación, en el Portal de administración de Azure, configure los permisos para la aplicación.
2Su aplicación obtiene la dirección de correo electrónico del usuario. Pone en contacto el Servicio de detección con la dirección de correo electrónico y el conjunto de ámbitos a los que la aplicación desea acceder.Su aplicación solicita un código de autorización para el Servicio de detección.
3La aplicación va al punto de conexión de autorización de Azure AD y el usuario autentica y otorga el consentimiento (si este no se ha otorgado anteriormente). Azure AD emite un código de autorización.El usuario autentica y otorga su consentimiento. Azure AD emite un código de autorización.
4La aplicación canjea el código de autorización. Azure devuelve un token de acceso y un token de actualización.La aplicación canjea el código de autorización. Azure devuelve un token de acceso y un token de actualización.
5La aplicación llama al Servicio de detección utilizando el token de acceso. El Servicio de detección devuelve Http Response con los Id. de recurso y URI de punto de conexión de los servicios de Office 365.La aplicación llama al Servicio de detección utilizando el token de acceso. El Servicio de detección devuelve Http Response con los Id. de recurso y URI de punto de conexión de los servicios de Office 365.
6La aplicación canjea el token de actualización con el punto de conexión del token de Azure AD, para obtener el token de acceso para el recurso de Office 365 que se desea. El punto de conexión del token de Azure AD devuelve un token de acceso para el recurso especificado y un token de actualización.La aplicación canjea el token de actualización con el punto de conexión del token de Azure AD, para obtener un token de acceso para el recurso de Office 365 que se desea. El punto de conexión del token de Azure AD devuelve un token de acceso y un token de actualización.
7Ahora, la aplicación llama a las API de Office 365 usando el URI del Servicio de detección y el token de acceso. Office 365 devuelve Http Response.Ahora, la aplicación llama a las API de Office 365 usando el URI del Servicio de detección y el token de acceso.

Para ver un ejemplo que muestra cómo usar el Servicio de detección, consulte API de Office 365: cómo usar el servicio de detección.

Para obtener información sobre las API que usa el Servicio de detección, consulte Referencia de operaciones de API REST del Servicio de detección.

Recursos adicionales

© 2018 Microsoft