Source HTTP
En bref
La source HTTP permet a la plateforme d'interroger periodiquement une API externe pour recuperer des donnees. Contrairement au webhook ou c'est le systeme externe qui envoie les donnees (mode push), la source HTTP fonctionne en mode pull : c'est Ontologie qui interroge l'API a intervalles reguliers.
Avant de commencer
- Acces a un workspace avec le module Live Data
- L'URL d'une API externe qui retourne des donnees JSON
- Les identifiants d'authentification si l'API est protegee
Comment ca marche
- Vous configurez l'URL de l'API et testez la connexion.
- Vous liez la source a une entite de votre ontologie.
- Ontologie interroge automatiquement l'API selon l'intervalle choisi et ingere les nouvelles donnees.
Assistant de configuration (2 etapes)
Depuis le catalogue Live Data, cliquez sur Configurer sur la carte Source HTTP (section Sources Directes). L'assistant se deroule en 2 etapes.
Etape 1 — Connexion
Configurez et testez la connexion a l'API externe.
| Champ | Description | Obligatoire |
|---|---|---|
| Nom de la source | Nom explicite (ex. API Meteo, CRM Clients, Inventaire). Minimum 2 caracteres. | Oui |
| Methode HTTP | GET (defaut), POST ou PUT | Oui |
| URL | Adresse complete de l'API (ex. https://api.example.com/data) | Oui |
Authentification (optionnel)
La section est repliee par defaut. Depliez-la si l'API necessite une authentification :
| Mode | Configuration |
|---|---|
| Aucune | Pas d'authentification (API publique) |
| API Key | Nom du header (defaut : Authorization), prefixe (defaut : Bearer ) et valeur de la cle. L'assistant affiche un apercu du header final envoye. |
| Basic | Identifiant et mot de passe |
Test de connexion
Cliquez sur le bouton TEST pour verifier que l'API repond correctement. Le resultat affiche :
| Resultat | Informations affichees |
|---|---|
| Succes (vert) | Code HTTP, temps de reponse, nombre d'enregistrements detectes, schema des champs |
| Erreur (rouge) | Categorie de l'erreur, message, action de recuperation suggeree, details techniques (depliable) |
Le test de connexion doit reussir avant de pouvoir passer a l'etape suivante.
Cliquez sur Suivant pour passer a l'etape 2.
Etape 2 — Activation
Liez la source a une entite et configurez la frequence de synchronisation.
Liaison a une entite
Recherchez et selectionnez l'entite cible dans votre ontologie. Les donnees recuperees depuis l'API seront associees a cette entite.
Polling automatique
Un interrupteur permet d'activer ou desactiver le polling automatique :
| Mode | Comportement |
|---|---|
| Active (defaut) | L'API est interrogee automatiquement a intervalles reguliers |
| Desactive | Synchronisation manuelle uniquement (a la demande) |
Si le polling est active, choisissez l'intervalle de synchronisation :
| Intervalle | Syncs / jour | Syncs / mois |
|---|---|---|
| 15 min | ~96 | ~2 880 |
| 30 min | ~48 | ~1 440 |
| 1 h | ~24 | ~720 |
| 6 h | ~4 | ~120 |
| 24 h | 1 | ~30 |
Cliquez sur Creer et activer pour finaliser la creation de la source.
Liaison a une entite de l'ontologie
Lorsque vous creez une source HTTP depuis l'onglet Sources d'une entite dans l'ontologie, la liaison est automatique : les donnees synchronisees sont directement associees a cette entite.
Comment ca marche
- Ouvrez une entite dans l'ontologie et cliquez sur l'onglet Sources.
- Dans la section Connecteurs Directs, selectionnez l'onglet HTTP puis cliquez sur Creer HTTP.
- Configurez l'URL et testez la connexion (etape 1).
- La source est automatiquement liee a l'entite courante. Les donnees synchronisees apparaissent dans le contexte de cette entite.
Depuis le catalogue Live Data
Si vous creez une source HTTP depuis le catalogue Live Data, l'etape 2 du wizard vous permet de selectionner l'entite cible manuellement.
Creer une source HTTP directement depuis l'onglet Sources d'une entite est le moyen le plus simple : la liaison est automatique et le contexte de l'entite est pre-rempli.
→ En savoir plus : Liaison aux entites
Resultat attendu
Votre source HTTP est creee et active. Les donnees sont recuperees automatiquement selon l'intervalle configure et associees a l'entite cible. Vous pouvez suivre l'etat des synchronisations dans le Monitoring.
Limites
| Limite | Valeur |
|---|---|
| Methodes supportees | GET, POST, PUT |
| Timeout de requete | 30 secondes |
| Intervalle minimum | 15 minutes |
| Requetes simultanees | Rate limite par workspace |
Voir aussi
- Source Webhook — Reception en temps reel (mode push)
- Monitoring — Suivre vos synchronisations
- Diagnostic — Resoudre les erreurs de connexion
- Support et contact