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

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

Point de terminaison de l’API

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

• URL de base : https://{yourDomain}/{organizationName}/{tenantName}/dataservice_

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
id (Required)	string	L'ID de l'enregistrement de l'entité que vous souhaitez récupérer à partir de Data Service.	NA

Paramètres de requête

Paramètre de requête	Type de données	Description	Valeur par défaut
NiveauDéveloppement (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 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.