Obtenir un enregistrement d’entité à partir d’un identifiant

Référence d'API pour récupérer un enregistrement d'entité unique par ID dans Data Service, avec l'URL du point de terminaison, les paramètres de chemin d'accès et les exemples de charges utiles.

Récupère un seul enregistrement d'entité par ID.

Point de terminaison de l’API

GET BaseURL/EntityService/<Entity>/read/{id}

• Selon la plateforme Cloud que vous utilisez, utilisez l' URL de base associée.

En-têtes de requête.

En-tête	Valeur (Value)
Autorisation	Porteur <access_token>

Remarque :

Remplacez toutes les valeurs entre les chevrons <...> par leurs valeurs de cas d’utilisation correspondantes.

Le <access_token> est celui que vous avez reçu lorsque vous avez autorisé l’application externe. Il est disponible pendant 1 heure, puis vous devez en générer un nouveau ou demander un jeton d'actualisation.

Variables de chemin d'accès

Variable de chemin d’accès	Type de données	Description	Valeur par défaut
identifiant (obligatoire)	string	L’ID de l’enregistrement de l’entité que vous souhaitez récupérer depuis Data Fabric/Data Service.	NA

Paramètres de requête

Paramètre de requête	Type de données	Description	Valeur par défaut
NiveauExtension (facultatif)	int32	Spécifie la profondeur des enregistrements associés à récupérer. La valeur de ce paramètre peut être 1, 2 ou 3.	2

Réponses

200 OK

{
  "ClosingDate": "2021-03-04",
  "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "CreateTime": "2021-03-04T10:20:24.485Z",
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Logo": {
    "Name": "string",
    "Path": "string",
    "Size": 0,
    "Type": "string"
  },
  "Name": "string",
  "Nations": 0,
  "OlymipcsVersion": 0,
  "OpeningDate": "2021-03-04",
  "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "UpdateTime": "2021-03-04T10:20:24.485Z"
}

401 Non autorisé

Votre authentification ne vous permet pas d’accéder à Data Fabric/Data Service. Assurez-vous que votre Assistant ou votre robot est connecté à un dossier moderne de votre compte.

403 Forbidden

Vous n'êtes pas autorisé à accéder à l'entité, au champ ou à l'enregistrement, ou vous utilisez un type de robot non pris en charge. Contactez votre administrateur pour obtenir les autorisations nécessaires.