Propriétés REST - Cloud

Guide des connecteurs des applications Talend Cloud

author
Talend Documentation Team
EnrichVersion
Cloud
EnrichProdName
Talend Cloud
task
Administration et monitoring > Gestion des connexions
Création et développement > Création de Pipelines
EnrichPlatform
Talend Pipeline Designer

Propriétés à configurer pour pouvoir envoyer une requête HTTP au serveur et obtenir les informations de réponse correspondantes depuis le serveur.

Le client HTTP sous-jacent est le client HTTP par défaut embarqué avec Java.

Connexion REST

Propriété

Configuration

Connection name Saisissez un nom pour la connexion.
Description (facultatif) Saisissez une description pour la connexion.
Engine Sélectionnez votre moteur dans la liste.
Connection type

Sélectionnez Http Rest dans la liste.

Principal Base URL Renseignez l'adresse URL du serveur Web REST à invoquer.
Authentification Sélectionnez la manière dont vous souhaitez authentifier le serveur :
  • Sélectionnez No authentication si vous n'avez pas besoin de vous authentifier pour accéder au serveur.
  • Sélectionnez Basic si vous devez fournir un identifiant et un mot de passe pour accéder au serveur.
  • Sélectionnez Digest si vous devez fournir un identifiant et un mot de passe au sein d'un algorithme de type Digest pour accéder au serveur.
  • Sélectionnez Bearer Token si vous devez vous authentifier pour accéder au serveur à l'aide d'un jeton d'accès.
Advanced Connection timeout (ms) Configure le temps maximal en millisecondes attendu par un utilisateur pour une connexion disponible. Si ce temps est dépassé et que la connexion est toujours indisponible, une exception est retournée.
Read timeout (ms) Configure le temps maximal d'attente en millisecondes pour qu'une connexion soit considérée comme active. Une exception est retournée si le délai avant suspension est expiré avant que les données soient disponibles à la lecture.

Jeu de données REST

Propriété Configuration
Dataset name Saisissez un nom pour le jeu de données.
Connection Sélectionnez votre connexion dans la liste.
Type Sélectionnez le type de jeu de données à créer :
  • Batch si vous souhaitez invoquer un service d'API REST une fois. Le pipeline utilisant ce jeu de données sera un pipeline de type batch.
  • Streaming si vous souhaitez invoquer une API REST toutes les N millisecondes dans un pipeline de type streaming. Le pipeline utilisant ce jeu de données sera un pipeline de type streaming et vous pourrez définir l'intervalle d'interrogation en millisecondes dans le champ Delay du jeu de données source.
Main Ressource Saisissez la ressource HTTP à consommer à partir de l'API REST.
HTTP method Sélectionnez la méthode de requête HTTP dans la liste.
Answer body format Sélectionnez le format du corps du message que vous recevez comme réponse côté serveur :
  • JSON : sélectionnez ce format si le service REST retourne un message JSON. Ainsi, le payload sera traduit en enregistrements JSON parsés.
  • Text : sélectionnez ce format si le service REST retourne un message d'un autre format, comme XML ou si vous souhaitez récupérer un JSON non parsé que vous pouvez traiter manuellement dans votre pipeline.
Paramètres de requête Spécifiez les paramètres de la requête URI sous forme de paires nom-valeur.
Advanced Get status and headers Activez cette option pour demander le statut et les en-têtes. Par défaut, seul le corps est retourné.
Maximum number of redirects Configurez le nombre maximal de redirections que doit suivre le connecteur. Si vous saisissez 0, aucune redirection n'est effectuée. Si vous saisissez -1, la restriction est désactivée.
Redirect only on same host Activez cette option si vous souhaitez que les redirections soient effectuées uniquement lors de l'utilisation du même hôte.
Force GET method for 302 redirection Activez cette option pour envoyer la requête de redirection avec la méthode GET si le code de redirection est 302.