Skip to main content
Formulaire de configuration de la source URL

​
Présentation

Le type de source URL récupère des données depuis une adresse web. Utilisez-le pour les endpoints d’API, les fichiers CSV/JSON hébergés ou tout flux de données accessible via HTTP/HTTPS.

​
Configuration

​
Champs obligatoires

​
Options HTTP

Ces champs sont imbriqués sous l’objet options.

​
Authentification

Pour les URLs accessibles publiquement, aucune configuration supplémentaire n’est nécessaire.

​
Formats de fichiers pris en charge

La source URL détecte automatiquement le format de la réponse. Les formats suivants sont pris en charge :
Les réponses compressées (.gz, .zip) sont automatiquement décompressées avant le parsing.

​
Déchiffrement PGP

La source URL prend en charge la récupération de fichiers chiffrés PGP. Lorsque pgpPrivateKey est configuré, la réponse est déchiffrée avant la décompression et le parsing. Les fichiers chiffrés armored (.asc) et binary (.pgp, .gpg) sont pris en charge.
Consultez le guide de déchiffrement PGP pour plus de détails sur la génération de clés, les formats pris en charge et la gestion des erreurs.

​
Pagination

Pour les APIs qui paginent leurs réponses, la source URL prend en charge plusieurs stratégies de pagination :
Incrémente un paramètre de requête (numéro de page ou offset) à chaque requête.
Vous pouvez optionnellement définir maximumPage pour limiter le nombre de pages récupérées lors d’une synchronisation.

​
Variables d’exécution

Pour les endpoints d’API qui nécessitent des paramètres dynamiques (par ex. date actuelle, IDs spécifiques à l’utilisateur), vous pouvez définir des variables qui sont résolues au moment de la récupération. Chaque variable possède : Les variables peuvent être référencées dans l’URL, les en-têtes, le body et les paramètres de requête. Cela permet de construire des URLs dynamiques comme https://api.example.com/products?since={{last_sync_date}}.

​
Fonctionnement

  1. Reelevant envoie une requête HTTP à l’URL configurée avec la méthode, les en-têtes et le body spécifiés.
  2. Si la pagination est configurée, les pages suivantes sont récupérées automatiquement.
  3. La réponse est parsée selon le format détecté.
  4. Les champs sont extraits et rendus disponibles pour le mapping.
  5. Lors des synchronisations suivantes, l’URL est re-récupérée et les données sont mises à jour.
Assurez-vous que votre URL renvoie des données dans un format pris en charge. La plateforme détecte automatiquement le format à partir du type de contenu et du contenu de la réponse.