Explorer l’API managée EWS, EWS et les services web dans Exchange

Ce document peut contenir des informations liées aux fonctionnalités ou produits préliminaires qui sont sujettes à modifications avant la sortie de la version définitive. Ce document est fourni "tel quel" à titre indicatif et Microsoft exclut toute garantie, expresse ou implicite, en ce qui concerne ce document.

Découvrez les services web disponibles dans Exchange.

Dernière modification :lundi 9 mars 2015

S’applique à :EWS Managed API | Exchange Online | Exchange Server 2013 | Office 365

Vous pouvez utiliser Exchange Web Services (EWS) et d’autres services web dans Exchange Online, Exchange Online dans le cadre d’Office 365 ou Exchange sur site pour créer des solutions permettant aux utilisateurs d’accéder aux données de boîtes aux lettres Exchange à partir des services, des sites web, des ordinateurs de bureau et des appareils mobiles. Cet article présente les services web qui sont disponibles dans Exchange.

Le tableau suivant permet de rechercher des articles et du contenu de référence pour les technologies qui vous intéressent. Sinon, lisez les informations figurant après le tableau pour obtenir une présentation plus approfondie de chacune de ces technologies.

Remarque Remarque

Les conditions spécifiées dans Informations de licence s’appliquent à votre utilisation de ce contenu. Étudiez attentivement les conditions.

Tableau 1. Services web et technologies connexes dans Exchange

L’API managée EWS est l’interface recommandée pour le développement d’applications clientes qui utilisent EWS et la découverte automatique pour communiquer avec Exchange. Vous pouvez utiliser l’API managée EWS pour les messages électroniques, le calendrier, les tâches et les coordonnées, et autoriser l’accès par programme aux boîtes aux lettres, dossiers publics et boîtes aux lettres de dossiers publics. L’API permet l’accès par programme à la plupart des ressources Exchange dans un format plus intuitif que les messages SOAP EWS sous-jacents ou que les classes proxy générées, désormais obsolètes. Presque toutes les fonctionnalités disponibles dans les opérations EWS sous-jacentes sont disponibles dans l’API managée EWS, bien qu’il existe des différences mineures.

L’API managée EWS est, pour l’essentiel, un wrapper pour EWS. Les appels SOAP EWS sont envoyés par l’API managée EWS et les réponses SOAP EWS sont également analysées et gérées par l’API managée EWS.

Remarque Remarque

L’API managée EWS est désormais disponible comme projet Open Source sur GitHub. Vous pouvez utiliser la bibliothèque Open Source pour :

  • participer aux résolutions de bogues et aux améliorations apportées à l’API ;

  • obtenir des correctifs et des améliorations avant qu’ils soient disponibles dans une version officielle ;

  • accéder à l’implémentation la plus complète et la plus à jour de l’API, afin de l’utiliser comme référence ou pour créer des bibliothèques sur de nouvelles plateformes.

Vos contributions sont les bienvenues sur GitHub.

Tableau 2. Ce que vous devez savoir au sujet de l’API managée EWS

Si vous vous posez des questions sur...

Voici la réponse

La disponibilité de l’API

Disponible pour le téléchargement.

Les langages pris en charge

N’importe quel langage .NET Framework.

Les outils de test et de débogage disponibles

Utilisez les différentes versions de Visual Studio, à partir de Visual Studio 2010 pour déboguer des applications d’API managée EWS.

L’API managée EWS contient également une fonction de suivi qui capture les messages XML SOAP qui sont envoyés et reçus. Pour plus d’informations, voir Outils et ressources pour la résolution des applications EWS pour Exchange.

Exigences en matière de plateforme de serveur

Exchange Online et Exchange sur site.

EWS fournit un ensemble d’opérations que les applications clientes utilisent pour accéder et gérer les éléments de la banque Exchange. Tout comme l’API managée EWS, vous pouvez utiliser EWS avec les messages électroniques, le calendrier, les tâches et les coordonnées et autoriser l’accès par programmation aux boîtes aux lettres, dossiers publics et boîtes aux lettres de dossiers publics. Avec les services Web Exchange, les données sont envoyées vers et depuis le serveur Exchange à l’aide de code XML qui est basé sur une définition de schéma. L’application cliente crée une requête XML, l’envoie au serveur et reçoit une réponse XML avec des données qui sont ensuite analysées par le client.

Tableau 3. Ce que vous devez savoir sur EWS

Si vous vous posez des questions sur...

Voici la réponse

La disponibilité de l’API

Le langage de description de services (WSDL) et les schémas qui définissent le contrat EWS sont disponibles dans Exchange Online ou sur le serveur d’accès au client Exchange.

Les langages pris en charge

EWS est basé sur des normes du secteur. Vous pouvez utiliser n’importe quel langage ou outil qui peut envoyer et recevoir des messages XML SOAP pour développer sur EWS.

Les outils de test et de débogage disponibles

Vous n’avez pas besoin d’outils de débogage spécifiques pour déboguer des applications qui utilisent EWS.

Pour des problèmes particulièrement difficiles, un outil de surveillance du réseau peut être utile. Vous pouvez utiliser l’outil Netmon.exe ou Fiddler.exe pour déboguer EWS. Pour plus d’informations, voir Outils et ressources pour la résolution des applications EWS pour Exchange.

Exigences en matière de plateforme de serveur

Exchange Online et Exchange sur site.

Le service de découverte automatique SOAP a été introduit dans Exchange 2010. Si vous ciblez une version d’Exchange, à partir d’Exchange 2010, y compris Exchange Online, nous vous recommandons d’utiliser le service de découverte automatique SOAP, plutôt que le service de découverte automatique POX, pour obtenir des données de configuration du client à partir d’Exchange.

Comme le service de découverte automatique POX, le service de découverte automatique SOAP fournit des informations de configuration, comme l’URL EWS, mais il permet un contrôle plus précis des paramètres requis. Le service de découverte automatique SOAP fournit également des informations supplémentaires sur l’état fédéré d’une organisation.

Le service de découverte automatique POX (plain old XML) permet aux applications de configurer automatiquement les paramètres utilisateur. Vous pouvez utiliser le service de découverte automatique pour déterminer les paramètres du client en fonction d’une adresse de messagerie d’utilisateur uniquement. L’utilisation du service de découverte automatique POX permet aux clients d’obtenir automatiquement l’URL du service EWS.

Vous pouvez utiliser le service de découverte automatique POX pour configurer des applications clientes qui ciblent des versions d’Exchange, à partir d’Exchange 2007, y compris Exchange Online. Le service de découverte automatique POX ne vous permet pas de spécifier les paramètres qui sont renvoyés dans la réponse. Il est recommandé que les clients qui ciblent des versions d’Exchange, à partir d’Exchange 2010 ou Exchange Online utilisent le service de découverte automatique SOAP, car celui-ci offre un contrôle plus précis des paramètres requis.

Les API REST de courrier, calendrier et contact permettent d’accéder facilement aux données Exchange Online et de les manipuler aisément à l’aide des normes ouvertes OAuth et OData. Étant donné que ces API exigent OAuth version 2.0 pour l’authentification, votre application n’a pas à gérer ni à stocker les informations d’identification des utilisateurs. OAuth permet également de demander des autorisations bien définies pour accéder aux données utilisateur.

L’API REST de photo d’utilisateur, introduite dans Exchange Server 2013 et Exchange Online, vous permet de récupérer la photo d’un utilisateur à partir d’Exchange ou des services de domaine Active Directory (AD DS). Vous pouvez utiliser ce service au lieu d’exécuter l’opération EWS Opération de GetUserPhoto.

Le service web de messagerie unifiée fournit un ensemble d’opérations qui permettent aux clients d’accéder aux fonctionnalités de messagerie unifiée tels que l’émission et la gestion d’appels téléphoniques qui lisent les éléments de boîte aux lettres (y compris les messages vocaux) sur les périphériques de téléphonie, la réinitialisation du code PIN, l’activation des notifications d’appel manqué, l’activation des messages sonores Absent(e) du bureau et l’obtention des paramètres de messagerie unifiée. Dans les versions d’Exchange, à partir d’Exchange 2010, y compris Exchange Online, EWS fournit des fonctionnalités de messagerie unifiée.

Afficher: