Télécharger le fichier vers le champ d’enregistrement

Télécharge un fichier vers le champ spécifique d’un enregistrement d’entité existant.

Point de terminaison de l’API

BaseURL/Attachment/<Entity>/{recordId}/{fieldName}

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

En-têtes de requête.

En-tête	Valeur (Value)
Autorisation	Porteur <access_token>
Type de contenu	multipart/form-data

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
RecordId (Requis)	string	L'ID de l'enregistrement de l'entité Data Service dans lequel vous souhaitez télécharger le fichier.	NA
Nom du champ (requis)	string	Le nom du champ Type de fichier dans lequel l'enregistrement que vous souhaitez télécharger est trouvé. Le nom doit correspondre à un champ valide et est sensible à la casse.	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

Corps de la requête (obligatoire)

Le fichier (binaire).

Réponses

200 OK

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, ni à l’enregistrement, ou utilisez un type de robot non pris en charge. Contactez votre administrateur afin d’obtenir les autorisations requises.