Connecteur
Connecteur de service web REST
Votre système ne figure pas dans la liste ? S'il dispose d'une API REST, Rapidi peut généralement s'y connecter.
Oui, s'il dispose d'une API REST. La connexion de service web REST de Rapidi transfère des données vers et depuis des services REST, et découvre leurs objets et leurs champs à partir d'une description JSON Schema ou Swagger 2.0. Il n'existe pas de norme REST unique, si bien que certains services demandent une configuration supplémentaire. Indiquez-nous le service que vous prévoyez d'utiliser et nous le planifierons avec vous.
- À quoi il se connecte
- Tout service web REST, dans le cloud ou sur votre propre réseau.
- Dans quel sens circulent les données
- Dans les deux sens. Rapidi transfère les données vers et depuis le service.
- Ce qu'il vous faut
- L'adresse du service, un moyen de s'authentifier et, idéalement, une description JSON Schema ou Swagger 2.0 de l'API.
Que fait concrètement ce connecteur ?
En bref : vous indiquez à Rapidi le service REST, il lit la description de l'API, et chaque objet et chaque champ de cette description devient un élément que vous pouvez mapper.
| Ce qu'il lit | Les objets et les champs décrits dans les métadonnées JSON Schema ou Swagger 2.0 du service. Vous saisissez l'URL des métadonnées et cliquez sur Read Design. |
|---|---|
| Sens | Dans les deux sens. La connexion transfère les données vers et depuis le service REST. |
| Authentification | Aucune authentification, Basic (identifiant utilisateur et mot de passe), un jeton, une demande de jeton qui renvoie un jeton JWT de type bearer, OAuth2 avec Azure Active Directory, ou NTLM sur un réseau local. |
| Gros volumes de données | Lecture paginée. Un filtre source tel que limit=20 amène Rapidi à ajouter un décalage (offset) à chaque requête, jusqu'à ce qu'aucune donnée ne soit plus renvoyée. |
| Enregistrements modifiés uniquement | Source Control ajoute à chaque requête la dernière valeur lue, de sorte que le service ne renvoie que les enregistrements plus récents. |
| Fréquence d'exécution | Selon un planning que vous définissez. L'intervalle le plus court dépend de votre formule, d'une heure avec Entry à une minute avec Unlimited. |
| Où il peut s'exécuter | Directement vers un point de terminaison REST sur Internet, ou via RapidiConnector pour les installations locales et les hébergements que vous maîtrisez. |
| Sécurité | Le SSL (HTTPS) est un paramètre de la connexion, et Rapidi recommande de toujours l'utiliser. |
Quels systèmes se connectent déjà de cette façon ?
Plusieurs systèmes décrits dans la documentation Rapidi utilisent cette même connexion, chacun avec un schéma JSON qui définit ce qui peut être mappé.
| Système | Utilisation | Authentification | Qui gère le schéma |
|---|---|---|---|
| Workday | Le plus souvent la source des données RH, comme les données de base des employés, les postes et la hiérarchie organisationnelle, à destination d'un ERP ou d'un CRM | Les points de terminaison REST de Workday | Le client, si bien qu'un nouveau champ Workday ne nécessite aucune modification de la part de Rapidi |
| Dayforce | Le plus souvent la cible des données de temps de travail et de paie des employés provenant d'un autre système opérationnel | Authentification par jeton auprès de l'API Dayforce | Le schéma définit chaque objet Dayforce pouvant être mappé |
| Storyblok | Récupération de contenu depuis le CMS headless Storyblok | Un jeton d'API Storyblok | Rapidi le construit à partir de votre documentation d'API et du périmètre de l'intégration |
Les services REST sont conçus de manières très diverses, car il n'existe pas de norme unique pour REST et JSON. Indiquez-nous quel service vous prévoyez d'utiliser et dans quel but, et nous vous dirons si nous l'avons déjà utilisé avec d'autres clients.
Par où continuer ?
Connecteurs
Tous les systèmes auxquels Rapidi se connecte
La liste complète, de A à Z, avec les versions et le mode de connexion de chacun.
Tous les connecteurs
Tarifs
Combien coûte Rapidi
Quatre formules, tarifées par abonnement plutôt que par connecteur.
Formules
Votre configuration
Renseignez-vous sur votre service REST
Indiquez-nous le service et ce que vous prévoyez de transférer, et nous vous dirons clairement ce que la configuration implique.
Parler à un consultant
Questions fréquentes
Rapidi peut-il se connecter à un système qui ne figure pas dans la liste des connecteurs ?
Généralement oui, si le système propose un service web REST. Rapidi y accède via la connexion générique de service web REST. Une configuration supplémentaire peut être nécessaire : indiquez-nous donc quel service vous prévoyez d'utiliser et dans quel but, et nous vous dirons si nous l'avons déjà utilisé avec d'autres clients.
Comment Rapidi découvre-t-il le contenu d'une API REST ?
À partir de sa description. Si le service publie des métadonnées JSON Schema ou Swagger 2.0, vous saisissez cette URL dans le champ Metadata URL et cliquez sur Read Design. Sinon, nous avons besoin que vous nous fournissiez le détail des points de terminaison, de préférence sous forme de JSON Schema.
Quelles méthodes d'authentification la connexion REST prend-elle en charge ?
Aucune authentification, Basic avec un identifiant utilisateur et un mot de passe, un jeton, une demande de jeton qui renvoie un jeton JWT de type bearer, OAuth2 avec Azure Active Directory, et NTLM sur un réseau local. Pour OAuth2 avec un annuaire autre qu'Azure Active Directory, contactez-nous.
Peut-il lire de gros volumes de données par pages ?
Oui. Ajoutez au transfert un filtre source tel que limit=20, et Rapidi ajoute un décalage (offset) à chaque requête jusqu'à ce qu'aucune donnée ne soit plus renvoyée.
Peut-il transférer uniquement les enregistrements modifiés ?
Oui. Le champ indiqué dans Source Control sur le transfert est ajouté à chaque requête avec la dernière valeur lue par Rapidi, de sorte que le service ne renvoie que les enregistrements plus récents.
Faut-il installer quelque chose de notre côté ?
Pas pour un service REST que Rapidi peut atteindre via Internet. Une nouvelle connexion REST est créée avec un RapidiConnector associé, que vous supprimez pour permettre à Rapidi de se connecter directement. RapidiConnector n'est nécessaire que pour les installations locales, les hébergements que vous maîtrisez ou l'authentification NTLM.
Combien coûte le connecteur de service web REST ?
Rien en soi. Rapidi est tarifé par formule d'abonnement plutôt que par connecteur : l'ajout d'un service REST ne modifie donc pas la licence.
Votre système ne figure pas dans la liste ?
Indiquez-nous le service que vous utilisez et ce qui doit être transféré, et nous vous dirons clairement si la connexion REST le couvre.