Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
L’API web fournit une interface de service web RESTful que vous pouvez utiliser pour interagir avec des données dans Microsoft Dataverse à l’aide d’un large éventail de langages de programmation et de bibliothèques. Utilisez les ressources suivantes pour savoir comment composer des requêtes, interroger des données, gérer des lignes de table et exécuter des opérations par lots, toutes à l’aide de méthodes HTTP standard.
Conseil / Astuce
Nouveautés de l’API web Dataverse ? Commencez par examiner les types d’API web et les opérations pour comprendre les documents de service OData qui définissent les entités, les fonctions et les actions disponibles.
Note
Les informations contenues dans cette section s’appliquent également aux utilisateurs Dynamics 365 Customer Engagement (local).
Dans cette section
| Article | Description |
|---|---|
| Composer des requêtes HTTP et gérer les erreurs | Découvrez comment définir les en-têtes HTTP appropriés et gérer les erreurs lors de l’interaction avec l’API web. |
| Données de requête | Apprenez à composer des requêtes à l’aide d’OData pour récupérer des données à partir de collections d’entités dans Dataverse. |
| Créer une ligne de table | Envoyez une POST demande pour créer des lignes de table, y compris les lignes associées dans une seule opération d’insertion approfondie. |
| Récupérer une ligne de table | Utilisez une GET demande pour récupérer un enregistrement spécifique par son identificateur unique, y compris des propriétés spécifiques et des enregistrements associés. |
| Mettre à jour et supprimer des lignes de table | Effectuez des opérations de mise à jour, de suppression et d’upsert sur des lignes de table, y compris des opérations sur des colonnes individuelles. |
| Associer et dissocier des lignes de table | Créez et supprimez des relations entre les enregistrements à l’aide des propriétés de navigation définies dans les métadonnées de la table. |
| Fusionner des lignes de table | Fusionnez deux enregistrements en double en un seul en utilisant l’action Merge pour les comptes, les contacts, les prospects et les incidents. |
| Utiliser des fonctions | Utilisez des fonctions réutilisables avec GET requêtes pour récupérer des données ou évaluer des valeurs dans des requêtes sans effets de bord. |
| Utiliser des actions | Utilisez des opérations réutilisables avec des requêtes POST pour effectuer des actions ayant des effets secondaires, y compris des actions personnalisées. |
| Exécuter des opérations de traitement par lots | Regroupez plusieurs opérations dans une requête HTTP unique, éventuellement dans un jeu de modifications pour vous assurer qu’elles réussissent ou échouent en tant qu’unité. |
| Emprunter l’identité d’un autre utilisateur | Exécutez une logique métier pour le compte d’un autre utilisateur, en appliquant le rôle de cet utilisateur et la sécurité basée sur des objets. |
| Effectuer des opérations conditionnelles | Utilisez les ETags pour effectuer des récupérations conditionnelles, un contrôle de concurrence optimiste et des opérations d'upsert limitées. |
| Détecter les données dupliquées | Utilisez l’en-tête MSCRM.SuppressDuplicateDetection pour détecter et empêcher la création d’enregistrements en double. |
| Résoudre les erreurs client Dataverse | Identifiez et résolvez les erreurs de client courantes rencontrées lors de l’utilisation de l’API Web Dataverse. |
Étapes suivantes
- S’authentifier auprès de Dataverse avec l’API web : configurez l’authentification avant d’effectuer votre première requête.
- Composez des requêtes HTTP et gérez les erreurs : commencez à générer des requêtes avec les en-têtes corrects et la gestion des erreurs.
- Types d’API web, fonctions et actions : explorez les documents de service OData qui définissent les opérations disponibles.