Connecteur Ubiflow

Ubiflow ne propose pas de OAuth pour applications tierces. L’authentification se fait avec4 identifiants statiques fournis par Ubiflow à l’hébergeur :

• client_id — identifiant numérique (ex.654321)
• client_code — formatag + chiffres (ex. ag654321)
• client_login — souvent identique auclient_code
• client_secret — mot de passe API

Ces 4 valeurs se récupèrent sur espace-dev.ubiflow.net, sectionParamètres > API. Si la section n’apparaît pas, demandez à votre référent Ubiflow l’activation des accès API (gratuit mais sur demande).

Sur Toppla, le wizard de connexion vit à /app/connect/ubiflow et se déroule en 3 étapes :

1. Guide— explication visuelle pour récupérer les 4 credentials depuis l’espace Ubiflow.
2. Credentials— formulaire 4 champs avec validation de format en temps réel ; bouton « Tester la connexion » qui interroge l’API Ubiflow pour valider les credentials avant sauvegarde.
3. Activation— choix de la fréquence de synchro et activation. La première synchro est lancée automatiquement.

Les 3 premiers identifiants sont stockés en clair (ils ne sont pas sensibles isolément). Le client_secret estchiffré en base via pgcryptoet n’est jamais affiché en clair après l’enregistrement. Toppla ne le déchiffre qu’au moment d’appeler l’API Ubiflow côté serveur.

En cas de doute sur la confidentialité d’une clé, régénérez le secret depuis votre espace Ubiflow puis re-saisissez-le dans Toppla — l’ancien sera révoqué côté Ubiflow.

• Manuelle— vous lancez la synchro depuis le module Connect quand vous le souhaitez. Idéal pour tester ou pour des portefeuilles très peu mouvants.
• Toutes les 6 h— recommandé si vous publiez ou dépubliez des biens plusieurs fois par jour.
• Toutes les 24 h (par défaut)— couvre 95 % des usages : vos biens sont à jour le matin et en début d’après-midi.

La fréquence se modifie à tout moment depuis la card Ubiflow du module Connect.

Les biens synchronisés depuis Ubiflow apparaissent dans Mes biensavec un badge « Ubiflow » qui les distingue des biens saisis manuellement. Ils sont enlecture seule : la source de vérité reste Ubiflow, toute modification se fait depuis votre espace Ubiflow et se propage à la prochaine synchro.

Côté entreprise (Bourse aux logements), aucune distinction n’est visible — les biens Ubiflow apparaissent comme n’importe quel autre bien disponible.

• Backend de synchronisation en cours d’implémentation : actuellement seul le wizard UI et l’endpoint de test des credentials sont livrés. La synchro automatique périodique arrive prochainement.
• Pas de mapping fin configurable : tous les biens disponibles côté Ubiflow sont synchronisés tels quels.
• Pas de webhook Ubiflow → Toppla en temps réel ; uniquement le polling selon la fréquence choisie.
• Une organisation Toppla = un compte Ubiflow (pas de multi-comptes).

Pour toute question sur le connecteur Ubiflow, écrivez-nous à support@toppla.fr.

Documentation Ubiflow officielle (référence pour les développeurs côté Ubiflow) :

• espace-dev.ubiflow.net
• api.ubiflow.net/api-tools/documentation