Utiliser Insomnia avec l’API Web Dataverse

Vous pouvez utiliser de nombreux outils clients d’API pour vous authentifier auprès des environnements Microsoft Dataverse et composer et envoyer des demandes d’API web. Ces outils facilitent l’apprentissage, le test et l’exécution de requêtes ad hoc à l’aide de l’API Web Dataverse.

Cet article a deux objectifs :

Illustrez une stratégie d’authentification et de connexion à Dataverse à l’aide du client d’API Insomnie avec un ID d’application Microsoft Entra (client) fourni par Microsoft pré-approuvé pour tous les environnements Dataverse. À l’aide de cette stratégie, vous n’avez pas besoin d’inscrire une application pour commencer à utiliser l’API Web Dataverse.
Présentation de certaines opérations de données de base que vous pouvez effectuer à l’aide de l’API Web Dataverse dans le contexte du client d’API Insomnie. À l’aide de cette approche, vous pouvez utiliser Insomnie pour continuer à expérimenter et en savoir plus sur l’API Web Dataverse.

Note

Les instructions contenues dans cet article représentent l’expérience fournie par Insomnia lors de la rédaction de cet article. L’expérience utilisateur change probablement au fil du temps et cet article peut ne pas représenter l’expérience actuelle. L’article se met à jour uniquement lorsque des modifications se produisent qui interrompent fondamentalement les étapes décrites ici. Pour en savoir plus, consultez la documentation Sur l’insomnie.

Confidentialité

Les demandes que vous envoyez à l’aide des outils d’API client contiennent des informations qui peuvent être sensibles. De nombreux développeurs ne souhaitent pas charger ces informations dans un service cloud.

Le Bloc-notes local Insomnia ne nécessite pas que vous créiez un compte, ni ne stocke d’informations sur les requêtes que vous envoyez. Les instructions fournies ici décrivent comment utiliser uniquement le bloc-notes local d'Insomnia. Vous pouvez choisir de créer un compte et d’utiliser toutes les fonctionnalités d’Insomnia si vous le souhaitez. Si vous souhaitez une version qui ne dispose d’aucune option pour créer un compte et qui est axée sur la confidentialité, consultez Insomnium.

Autres options

Vous pouvez également utiliser PowerShell avec Visual Studio Code pour vous authentifier auprès de l’API Web Dataverse comme alternative. Démarrage rapide : utiliser l’API web avec PowerShell et Visual Studio Code.

PowerShell avec Visual Studio Code :

Utilise l’enregistrement de l’application Azure AD afin que vous n’ayez pas besoin de fournir un identifiant d’application (client).
N’envoie aucune information sur vos requêtes nulle part.
Point de départ d’une série complète d’exemples d’API web que vous pouvez exécuter.

Installer Insomnia

Consultez la documentation d’Insomnia sur les étapes pour installer Insomnia. Les instructions diffèrent pour macOS, Windows et Linux.

Pour Windows, le programme d’installation est un fichier exécutable que vous téléchargez et exécutez. Une fois l’installation terminée, vous pouvez voir différentes options. Ces options ne devraient pas interférer avec les instructions de cet article, mais elles peuvent changer. Lorsque cet article a été écrit, le programme d’installation présente les options suivantes :

Pour l’option permettant d’activer les fonctionnalités pour synchroniser les données avec le cloud, choisissez Continuer à stocker localement dans le coffre local.
Pour l’option permettant de créer un compte, choisissez Utiliser le bloc-notes local. Apprenez-en davantage sur l’Insomnie Scratch Pad.

Configurer l’environnement de base

Utilisez les environnements Insomnia pour stocker des variables d’environnement. Les variables d’environnement sont un objet JSON contenant des paires de données clé-valeur que vous pouvez référencer à de nombreuses fins.

Vous affectez l’environnement de base à chaque espace de travail. Vous pouvez accéder aux variables dans l’espace de travail.

Après avoir ouvert Insomnia, sélectionnez l’icône d’engrenage en regard de l’environnement de base pour ouvrir la boîte de dialogue Gérer les environnements. Ou bien, utilisez le raccourci clavier Ctrl + E.

Copiez le JSON suivant :

{
   "url": "https://yourorg.api.crm.dynamics.com",
   "version": "9.2",
   "webapiurl": "{{ _.url }}/api/data/v{{ _.version }}/",
   "redirecturl": "https://localhost",
   "authurl": "https://login.microsoftonline.com/common/oauth2/authorize?resource={{ _.url }}",
   "clientid": "51f81489-12ee-4a9e-aaae-a2591f45987d"
}

Collez le JSON dans l’environnement de base.
Modifiez la valeur de la url propriété et remplacez la https://yourorg.api.crm.dynamics.com valeur pour qu’elle corresponde à l’URL de votre environnement Dataverse.

Vous trouverez le point de terminaison de l’API web pour votre environnement à l’aide des instructions fournies dans Afficher les ressources du développeur. Supprimez /api/data/v9.2 de l’URL du point de terminaison de l’API Web. Cette URL doit se terminer par dynamics.com.

Vous pouvez voir des avertissements indiquant que les références aux variables _.url et _.version ne sont pas résolues immédiatement, comme l’avertissement suivant :

Cependant, après avoir fermé la fenêtre et l’avoir rouverte, vous pouvez voir que les variables sont maintenant connues et résolues.

Créer des sous-environnements (facultatif)

Si vous n’avez jamais besoin de vous connecter à un seul environnement Dataverse, utilisez l’environnement de base. Si vous devez vous connecter à plusieurs environnements, créez des sous-environnements pour chaque environnement Dataverse. Par exemple, créez un sous-environnement pour vos environnements de développement et de test Dataverse.

Comme vous l'avez fait avec l'environnement de base, sélectionnez l'icône d'engrenage en regard de l'environnement de base pour ouvrir la boîte de dialogue Gérer les environnements. Ou bien, utilisez le raccourci clavier Ctrl + E.
Sélectionnez l’icône pour créer un nouvel environnement. Les environnements peuvent être partagés ou privés. Choisissez Environnement privé.
Double-cliquez sur le nom du nouvel environnement que vous avez créé et renommez-le comme vous le souhaitez. Vous pouvez lui donner le nom de l’environnement Dataverse auquel vous souhaitez vous connecter, ou quelque chose comme l’environnement de développement.

Copiez le JSON suivant :

{
   "url": "https://yourdevorg.api.crm.dynamics.com"
}

Collez le JSON dans l’environnement que vous avez créé.
Modifiez la valeur de la propriété url pour représenter le point de terminaison de l’API Web pour votre autre environnement, comme vous l’avez fait pour l’environnement de base.

Note

Vous devez uniquement inclure la propriété url du sous-environnement. Lorsque vous sélectionnez le sous-environnement, cette valeur remplace la url valeur spécifiée dans l’environnement de base. Vous pouvez également inclure l’une des cinq autres propriétés si vous le souhaitez, mais la valeur de la url propriété est la seule qui est différente pour chaque environnement Dataverse.

Configurer les requêtes

Après avoir configuré votre environnement de base et tous les sous-environnements, vous êtes prêt à configurer une demande.

Sélectionnez le bouton Nouvelle requête HTTP ou utilisez le raccourci clavier Ctrl+N.
Après la méthode HTTP, qui est GET par défaut, saisissez _. et attendez un instant. Insomnia affiche une liste de variables disponibles parmi lesquelles choisir :
Choisissez la variable _.webapiurl. Le champ APERÇU de l’URL affiche la valeur en utilisant la valeur de propriété url pour votre environnement sélectionné.
Dans l’onglet Authentification, utilisez la liste déroulante pour sélectionner le TYPE D’AUTHENTIFICATIONOAuth 2.0.

Modifiez la configuration de l’authentification comme indiqué dans le tableau suivant, en utilisant les variables d’environnement que vous avez créées :

Champ	Valeur
TYPE D’AUTORISATION	Implicite
URL D’AUTORISATION	`_.authurl`
ID CLIENT	`_.clientid`
URL DE REDIRECTION	`_.redirecturl`

Cliquez sur Envoyer.

Une boîte de dialogue s’ouvre pour entrer les identifiants de l’environnement.

Une fois que vous avez entré vos informations d’identification, vous voyez les résultats dans le volet Aperçu qui ressemblent à ceci :
```
{
"@odata.context": "https://yourorg.api.crm.dynamics.com/api/data/v9.2/$metadata",
"value": [
   {
      "name": "aadusers",
      "kind": "EntitySet",
      "url": "aadusers"
   },
   {
      "name": "accounts",
      "kind": "EntitySet",
      "url": "accounts"
   },
   {
      "name": "aciviewmappers",
      "kind": "EntitySet",
      "url": "aciviewmappers"
   },
   {
      "name": "actioncards",
      "kind": "EntitySet",
      "url": "actioncards"
   },
   ...
```
Ce résultat est le document de service de l’API Web. Vous affichez le document de service en envoyant une requête GET à la racine de l’URL du service de l’API Web. Il répertorie les noms des ensembles d’entités pour toutes les tables de votre environnement Dataverse. Lorsque vous pouvez voir le document de service, vous avez correctement authentifié votre environnement Dataverse.

Astuce

Il s’agit d’un moyen pratique de rechercher ou de vérifier le nom de l’ensemble d’entités pour une table que vous utilisez.

Afficher le document CSDL $metadata

Le document Common Schema Definition Language (CSDL) $metadata est la source de vérité pour tout ce qui concerne l’API Web. Référencez-la fréquemment.

Modifiez l’URL en ajoutant $metadata?annotations=true après la variable _.webapiurl. L’URL doit être :

GET _.webapiurl$metadata?annotations=true
Cliquez sur Envoyer.

Dans le volet Aperçu, vous voyez un message indiquant Réponse de plus de 5 Mo masquée pour des raisons de performances, avec les options de enregistrer dans le fichier et Afficher quand même. Le fichier est volumineux, mais vous pouvez l’afficher en préversion sans problème.

Rechercher des définitions de types

Le document CSDL $metadata est volumineux. La version préliminaire d’Insomnia fournit un outil de filtrage des réponses dans la partie inférieure. Utilisez des requêtes XPath pour filtrer la réponse et trouver ce dont vous avez besoin. Le tableau suivant présente quelques exemples :

Rechercher	Requête XPath
Tous les types d’entités	`//*[local-name() = 'EntityType']`
EntityType du compte	`//*[local-name() = 'EntityType'][@Name = 'account']`
Toutes les fonctions	`//*[local-name() = 'Function']`
Fonction WhoAmI	`//*[local-name() = 'Function'][@Name = 'WhoAmI']`
Toutes les actions	`//*[local-name() = 'Action']`
L'action CreateMultiple	`//*[local-name() = 'Action'][@Name = 'CreateMultiple']`
Tous les types complexes	`//*[local-name() = 'ComplexType']`
Type complexe WhoAmIResponse	`//*[local-name() = 'ComplexType'][@Name = 'WhoAmIResponse']`
Tous les types d’énumérations	`//*[local-name() = 'EnumType']`
Type d’énumération AccessRights	`//*[local-name() = 'EnumType'][@Name = 'AccessRights']`

En savoir plus sur les types définis dans le document CSDL $metadata.

Envoyer une requête WhoAmI

Maintenant que vous êtes authentifié, modifiez votre requête pour appeler la fonction WhoAmI. Étant donné que WhoAmI est une fonction, utilisez une GET méthode. Cette fonction n’a pas de paramètres, elle est donc facile à utiliser. En savoir plus sur l’utilisation de Web API Functions.

Modifiez l’URL en ajoutant WhoAmI après la variable _.webapiurl. L’URL doit être :

GET _.webapiurl WhoAmI
Définissez les en-têtes de requête.

Comme décrit dans les en-têtes HTTP, chaque requête d’API web doit avoir un ensemble spécifique d’en-têtes de requête. Vous devrez peut-être modifier les valeurs d’en-tête pour différents comportements.

Dans l’onglet En-têtes, sélectionnez le bouton Ajouter pour saisir chacun des en-têtes courants suivants :

En-tête Valeur

Accept application/json

OData-MaxVersion 4.0

OData-Version 4.0

If-None-Match null

Prefer odata.include-annotations="*"

Ces en-têtes ne changent pas le comportement de la fonction WhoAmI, mais il est recommandé de commencer à les ajouter au début.

En-tête	Valeur
`Accept`	`application/json`
`OData-MaxVersion`	`4.0`
`OData-Version`	`4.0`
`If-None-Match`	`null`
`Prefer`	`odata.include-annotations="*"`

Cliquez sur Envoyer.

Dans le volet Aperçu , vous voyez les données correspondant au type complexe WhoAmIResponse.

{
   "@odata.context": "https://yourorg.api.crm.dynamics.com/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.WhoAmIResponse",
   "BusinessUnitId": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
   "UserId": "22cc22cc-dd33-ee44-ff55-66aa66aa66aa",
   "OrganizationId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
}

Récupérer des données

Pour utiliser Insomnie pour récupérer des enregistrements, définissez le nom de l’ensemble d’entités pour la ressource.

Modifiez l'URL pour supprimer WhoAmI après la variable _.webapiurl. Remplacez-le par accounts, le nom du jeu d’entités pour le type d’entité de compte. L’URL doit être :

GET _.webapiurl accounts
Dans l’onglet Paramètres, définissez les paramètres de votre requête.

Vous pouvez ajouter des paramètres individuellement en sélectionnant le bouton Ajouter. Mais vous pouvez également sélectionner l’option Modification en bloc, que vous pouvez trouver plus facile.
1. Sélectionnez l’option Modification en bloc.
2. Copiez les paramètres suivants :
```
$top: 3
$select: name,revenue,address1_city
$expand: primarycontactid($select=fullname)
$filter: address1_city eq 'Redmond'
```
Cette requête retourne les colonnes sélectionnées dans les trois premiers enregistrements de compte situés dans la ville de Redmond. Il inclut également des informations sur tout contact associé spécifié comme contact principal pour les comptes.
1. Collez les valeurs dans le champ PARAMÈTRES DE LA REQUÊTE.
  
  Votre requête devrait ressembler à ceci :

Cliquez sur Envoyer.

Dans le volet Aperçu , vous voyez les résultats comme suit :

{
"@odata.context": "https://yourorg.api.crm.dynamics.com/api/data/v9.2/$metadata#accounts(name,revenue,address1_city,primarycontactid(fullname))",
"@Microsoft.Dynamics.CRM.totalrecordcount": -1,
"@Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded": false,
"@Microsoft.Dynamics.CRM.globalmetadataversion": "2341840",
"value": [
   {
      "@odata.etag": "W/\"2343103\"",
      "name": "City Power & Light (sample)",
      "revenue@OData.Community.Display.V1.FormattedValue": "$100,000.00",
      "revenue": 100000.0,
      "address1_city": "Redmond",
      "accountid": "01eaf28f-81e1-ee11-904d-000d3a3517c4",
      "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar",
      "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid",
      "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency",
      "_transactioncurrencyid_value": "57f82f38-09c8-ee11-907a-00224803d046",
      "address1_composite": "Redmond",
      "primarycontactid": {
      "fullname": "Scott Konersmann (sample)",
      "contactid": "15eaf28f-81e1-ee11-904d-000d3a3517c4"
      }
   },
   {
      "@odata.etag": "W/\"2343104\"",
      "name": "Contoso Pharmaceuticals (sample)",
      "revenue@OData.Community.Display.V1.FormattedValue": "$60,000.00",
      "revenue": 60000.0,
      "address1_city": "Redmond",
      "accountid": "03eaf28f-81e1-ee11-904d-000d3a3517c4",
      "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar",
      "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid",
      "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency",
      "_transactioncurrencyid_value": "57f82f38-09c8-ee11-907a-00224803d046",
      "address1_composite": "Redmond",
      "primarycontactid": {
      "fullname": "Robert Lyon (sample)",
      "contactid": "17eaf28f-81e1-ee11-904d-000d3a3517c4"
      }
   },
   {
      "@odata.etag": "W/\"2343106\"",
      "name": "A. Datum Corporation (sample)",
      "revenue@OData.Community.Display.V1.FormattedValue": "$10,000.00",
      "revenue": 10000.0,
      "address1_city": "Redmond",
      "accountid": "07eaf28f-81e1-ee11-904d-000d3a3517c4",
      "_transactioncurrencyid_value@OData.Community.Display.V1.FormattedValue": "US Dollar",
      "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "transactioncurrencyid",
      "_transactioncurrencyid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "transactioncurrency",
      "_transactioncurrencyid_value": "57f82f38-09c8-ee11-907a-00224803d046",
      "address1_composite": "Redmond",
      "primarycontactid": {
      "fullname": "Rene Valdes (sample)",
      "contactid": "1beaf28f-81e1-ee11-904d-000d3a3517c4"
      }
   }
]
}

Note

Ces résultats incluent de nombreuses valeurs d’annotation telles que @OData.Community.Display.V1.FormattedValue, car l’en-tête de requête Prefer: odata.include-annotations="*" défini dans Envoyer une requête WhoAmI est défini pour renvoyer toutes les annotations. Découvrez comment demander des annotations spécifiques.

En savoir plus sur la façon d’interroger des données.

Créer un enregistrement

En utilisant Insomnie, vous pouvez définir plusieurs demandes que vous pouvez réutiliser. Un moyen simple de créer une demande qui conserve toutes les configurations dont vous disposez consiste à dupliquer une requête existante. Dans cette étape, dupliquez la requête définie dans la section Récupérer les données et créez une demande pour créer un enregistrement.

La requête que vous avez créée dans Récupérer les données a le nom par défaut Nouvelle requête, à moins que vous l’ayez modifié. Renommez la requête Récupérer les comptes.
Lorsque vous pointez le curseur de la souris sur la requête Récupérer les comptes, sélectionnez le menu déroulant et sélectionnez Dupliquer.
Dans la boîte de dialogue Dupliquer la requête, définissez le Nouveau nom sur Créer un compte.
Dans la nouvelle requête Créer un compte, modifiez la méthode HTTP de GET en POST. L’URL est déjà définie pour utiliser le nom du accounts jeu d’entités. Vous n’avez donc pas besoin de modifier autre chose ici. L’URL doit être :

POST _.webapiurl accounts
Sous l’onglet Paramètres , supprimez tous les paramètres, car ils ne sont pas utilisés pour l’opération de création.
Dans l’onglet Corps, utilisez le menu déroulant pour sélectionner JSON dans le groupe TEXTE :

Copiez le JSON suivant :

{
   "name": "An Example Account record (sample)",
   "revenue": 10000.0,
   "address1_city": "Redmond"
}

Collez le JSON dans le champ Corps.

Note

Avant de sélectionner Envoyer pour créer l’enregistrement, examinez les données sous les onglets Authentification et En-têtes . Étant donné que vous avez créé cette requête en dupliquant la demande Récupérer des comptes , vous réutiliez toutes les informations que vous avez configurées précédemment.
Sélectionnez Envoyer pour créer l’enregistrement.

Vous voyez que le service a retourné 204 Aucun contenu. Il n’y a donc aucun contenu à voir dans le volet Aperçu .

L’URL de l’enregistrement créé est visible dans la liste En-têtes. Recherchez l’en-tête de réponse odata-entityid. La valeur devrait ressembler à ceci :
```
https://yourorg.api.crm.dynamics.com/api/data/v9.2/accounts(5b4ced1c-88e1-ee11-904c-6045bd05e9d4)
```
Cette URL contient la valeur du champ de clé primaire pour l’enregistrement créé, dans ce cas la valeur de la propriété accountid.

En savoir plus sur la création d’enregistrements

Récupérer un enregistrement

Après avoir créé un enregistrement de compte et obtenu la valeur du champ clé primaire, utilisez cette valeur pour récupérer l’enregistrement. Commencez par dupliquer la requête Récupérer les comptes.

Dupliquez la requête Récupérer les comptes.
Nommez-le Récupérer le compte.
Modifiez l’URL pour ajouter la valeur accountid entre parenthèses après le nom de l’ensemble d’entités. Si le accountid compte que vous avez créé dans Créer un enregistrement était 5b4ced1c-88e1-ee11-904c-6045bd05e9d4, modifiez l’URL pour qu’elle soit :

GET _.webapiurl accounts(5b4ced1c-88e1-ee11-904c-6045bd05e9d4)
Dans l’onglet Paramètres, supprimez les paramètres $top, $expand et $filter, en ne laissant que le paramètre $select pour limiter le nombre de colonnes renvoyées.
Dans l’onglet En-têtes, cochez la case en regard de l’en-tête Prefer pour la désactiver afin qu’aucune annotation ne soit renvoyée.

Cliquez sur Envoyer.

La réponse retourne 200 OK et le volet Aperçu contient des données comme suit :

{
   "@odata.context": "https://yourorg.api.crm.dynamics.com/api/data/v9.2/$metadata#accounts(name,revenue,address1_city)/$entity",
   "@odata.etag": "W/\"2343128\"",
   "name": "An Example Account record (sample)",
   "revenue": 10000.0000000000,
   "address1_city": "Redmond",
   "accountid": "5b4ced1c-88e1-ee11-904c-6045bd05e9d4",
   "_transactioncurrencyid_value": "57f82f38-09c8-ee11-907a-00224803d046",
   "address1_composite": "Redmond"
}

En savoir plus sur la récupération d’enregistrements

Supprimer un enregistrement

Après avoir créé et récupéré un enregistrement à l’aide de la valeur de clé primaire, vous pouvez le supprimer.

Dupliquez la requête Récupérer le compte. Nommez la nouvelle demande Supprimer le compte.
Modifiez la méthode HTTP de GET à DELETE.

L’URL devrait toujours contenir les données avec le accountid de l’enregistrement que vous avez créé et récupéré auparavant :

DELETE _.webapiurl accounts(5b4ced1c-88e1-ee11-904c-6045bd05e9d4)
Dans l’onglet Paramètres, supprimez le paramètre $select, car il est inutile pour une opération de suppression.
Cliquez sur Envoyer.

Vous voyez que le service a retourné 204 Aucun contenu. Il n’y a donc aucun contenu à voir dans le volet Aperçu .

Essayez d’envoyer la demande Récupérer le compte maintenant. Elle retourne 404 Introuvable et le volet Aperçu affiche cette erreur :

{
   "error": {
      "code": "0x80040217",
      "message": "Entity 'account' With Id = 5b4ced1c-88e1-ee11-904c-6045bd05e9d4 Does Not Exist"
   }
}

Réactivez l’en-tête Prefer de la requête Récupérer le compte afin que toutes les annotations soient renvoyées.

Envoyez à nouveau la requête. Vous pouvez maintenant voir que de nombreuses annotations sont retournées avec la réponse 404 Introuvable :

{
   "error": {
      "code": "0x80040217",
      "message": "Entity 'account' With Id = 5b4ced1c-88e1-ee11-904c-6045bd05e9d4 Does Not Exist",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionSourceKey": "Plugin/Microsoft.Crm.Common.ObjectModel.AccountService",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiStepKey": "81cbbb1b-ea3e-db11-86a7-000a3a5473e8",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiDepthKey": "1",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiActivityIdKey": "ef7da2d8-c3bc-40f3-b67f-9d2981341086",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiPluginSolutionNameKey": "System",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiStepSolutionNameKey": "System",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionCategory": "ClientError",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionMessageName": "ObjectDoesNotExist",
      "@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionHttpStatusCode": "404",
      "@Microsoft.PowerApps.CDS.HelpLink": "http://go.microsoft.com/fwlink/?LinkID=398563&error=Microsoft.Crm.CrmException%3a80040217&client=platform",
      "@Microsoft.PowerApps.CDS.InnerError.Message": "Entity 'account' With Id = 5b4ced1c-88e1-ee11-904c-6045bd05e9d4 Does Not Exist"
   }
}

Ces détails ne sont pas utiles dans ce contexte, car le problème est évident. Mais ces détails pourraient être utiles dans d’autres scénarios. En savoir plus sur l'ajout de détails supplémentaires pour les erreurs.

En savoir plus sur la suppression d’enregistrements.

Étapes suivantes

Pour en savoir plus sur ce que vous pouvez faire avec l’API Web Dataverse, consultez les articles suivants :

En savoir plus sur les types et les opérations de l’API Web

Effectuer des opérations à l’aide de l’API Web

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-03-14

Partager via

Utiliser Insomnia avec l’API Web Dataverse

Confidentialité

Autres options

Installer Insomnia

Configurer l’environnement de base

Créer des sous-environnements (facultatif)

Configurer les requêtes

Afficher le document CSDL $metadata

Rechercher des définitions de types

Envoyer une requête WhoAmI

Récupérer des données

Créer un enregistrement

Récupérer un enregistrement

Supprimer un enregistrement

Étapes suivantes

Commentaires

Ressources supplémentaires