Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Tâches courantes de découverte de point de terminaison à l’aide de l’API du service de découverte

Concerne : Office 365

La fonctionnalité d’API Office 365 est également disponible via Microsoft Graph, une API unifiée qui inclut des API provenant d’autres services Microsoft tels qu’Outlook, OneDrive, OneNote, Planner et Office Graph, accessibles via un seul point de terminaison et avec un seul jeton d’accès. Nous vous recommandons l’utilisation de Microsoft Graph dans vos applications lorsque cela est possible.

Les API Office 365 donnent accès aux événements, aux contacts, à la messagerie et aux fichiers via les services Microsoft. Avant que les utilisateurs de votre application puissent accéder aux services Microsoft et aux ressources utilisateur, l’application a besoin de leurs points de terminaison. Le service de découverte vous permet de découvrir ces points de terminaison de manière dynamique et d’obtenir les informations nécessaires pour y accéder.

Le service de découverte expose une API RESTful. Les SDK client sont disponibles pour la plateforme .NET, Android et iOS. Le service de découverte supporte les Calendriers, Contacts, Courriers, MesFichiers (pour les points de terminaison OneDrive et OneDrive for Business), Notes (pour OneNote), et RootSite (pour SharePoint).

Remarque Le service de découverte fournit uniquement des fonctionnalités pour l’environnement en ligne Office 365 et ne fonctionne pas pour les déploiements locaux.

Pour en savoir plus sur les opérations du service de découverte, voir Référence des opérations de l’API REST de découverte de service. Pour obtenir des exemples de code sur l’utilisation de l’API de découverte de service pour rechercher des points de terminaison pour les services auxquels vous accédez à l’aide des API Office 365, voir API Office 365 : Comment utiliser le service de découverte et Exemple de service de découverte Office 365.

Les URI des points de terminaison de l’API pour le service de découverte sont les suivants.

Version v1.0 :

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

Version v2.0 :

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

L’ID de ressource pour le service de découverte :

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

Prérequis du service de découverte

Avant d'utiliser le service de découverte, vous devez Configurer votre environnement de développement Office 365.

Processus du service de découverte

Ce qui suit est le workflow d’une application utilisant le service de découverte.

Tableau 1. Interactions entre votre application, le service de découverte et Azure AD pour appeler les API Office 365

ÉtapeDescriptionWorkflow
1Enregistrez votre application dans le portail de gestion Azure et configurez le code de l’application avec l’ID client et l’URI de redirection. Ensuite, dans le portail Azure Management, configurez les autorisations pour l’application.
2Votre application récupère l’adresse e-mail de l’utilisateur. Elle contacte le service de découverte avec l’adresse e-mail et les étendues auxquelles elle souhaite accéder.Votre application demande un code d’autorisation pour le service de découverte.
3L'application accède au point de terminaison d’autorisation de Azure AD et l’utilisateur authentifie et accorde son consentement (si le consentement n’a pas été accordé auparavant). Azure AD émet un code d’autorisation.L’utilisateur s’authentifie et donne son accord. Azure AD émet un code d’autorisation.
4Votre application utilise le code d’autorisation. Azure renvoie un jeton d’accès et un jeton d’actualisation.Votre application utilise le code d’autorisation. Azure renvoie un jeton d’accès et un jeton d’actualisation.
5Votre application appelle le service de découverte à l’aide du jeton d’accès. Le service de découverte renvoie la réponse HTTP avec les ID de ressource et les URIs de point de terminaison pour les services Office 365.Votre application appelle le service de découverte à l’aide du jeton d’accès. Le service de découverte renvoie la réponse HTTP avec les ID de ressource et les URIs de point de terminaison pour les services Office 365.
6Votre application utilise le jeton d’actualisation avec le point de terminaison du jeton Azure AD pour obtenir le jeton d’accès pour la ressource Office 365 souhaitée. Le point de terminaison du jeton Azure AD renvoie un jeton d’accès pour la ressource spécifiée et un jeton d’actualisation.Votre application utilise le jeton d’actualisation avec le point de terminaison du jeton Azure AD pour obtenir un jeton d’accès pour la ressource Office 365 souhaitée. Le point de terminaison du jeton Azure AD renvoie un jeton d’accès et un jeton d’actualisation.
7Votre application peut désormais appeler les API Office 365 en utilisant l’URI du service de découverte et le jeton d’accès. Office 365 renvoie la réponse HTTP.Votre application peut désormais appeler les API Office 365 en utilisant l’URI du service de découverte et le jeton d’accès.

Pour un exemple montrant comment utiliser le service de découverte, voir API Office 365 : comment utiliser le service de découverte.

Pour plus d’informations sur les API utilisées par le service de découverte, voir Référence des opérations de l’API REST du service de découverte.

Ressources supplémentaires

© 2018 Microsoft