Skip to main content

Documentation Index

Fetch the complete documentation index at: https://doc.fluximmo.io/llms.txt

Use this file to discover all available pages before exploring further.

Cette page regroupe les questions revenant le plus souvent en intégration. Pour un sujet précis, suivez le lien vers la page dédiée.

​
Onboarding

Créez un compte sur my.fluximmo.io. Une clé test est générée automatiquement, valable 1 semaine, sans carte bancaire ni appel commercial. Voir Authentification.
Quotas réduits (~5 req/s, valable 7 jours) mais accès complet aux modules Search, Refetch, Analytics, IA et Géocodage. Seule restriction : la création d’alertes webhook se fait sur demande (par mail à [email protected]). Suffisante pour coder et valider une intégration de bout en bout.
Activation depuis votre espace client my.fluximmo.io — onglet API. Pas d’engagement initial, pas de paiement avant validation de votre intégration. Pour un besoin custom (volume élevé, endpoints non publics, devis sur-mesure), écrivez à [email protected].
Aucun engagement initial. Le pricing se fait au volume, et les conditions custom sont fixées au cas par cas selon votre besoin.

​
Property vs Advert

  • /properties : un objet par bien physique unique (dédupliqué). Idéal pour de la BDD, du matching, des analytics.
  • /adverts : un objet par annonce publiée (un même bien peut générer plusieurs adverts). Idéal pour suivre la diffusion, les changements de prix, les portails.
Voir la matrice de décision.
Posez-vous la question : « j’ai besoin du bien ou de l’annonce ? ». Si la réponse contient “diffusion”, “portail”, “prix qui change”, “republication” → adverts. Sinon → properties.
Les webhooks Properties livrent uniquement le flxId pour optimiser le débit. Vous appelez ensuite GET /v2/protected/properties/{flxId} (ou l’endpoint bulk) pour récupérer la donnée fraîche. Voir Webhooks.

​
Webhooks & alertes

  • Acquitter en moins d’1 seconde avec un code 2xx (200-205).
  • Mettre la logique métier en file d’attente côté worker (NE PAS traiter dans le handler HTTP).
  • Implémenter une logique UPSERT par flxId pour absorber les retries.
Voir Livraison des webhooks et le playbook Architecture haut volume.
La politique de retry peut livrer le même payload deux fois (ex : ack > 1s côté client, ou réponse 5xx transitoire). C’est attendu : votre logique de persistance doit être idempotente (UPSERT par flxId).
Le cycle de vie redémarre à zéro : vous re-recevrez les matches initiaux. Pour modifier les critères sans re-livraison, mettez à jour l’alerte existante plutôt que de la recréer. Voir Cycle de vie d’une alerte.

​
Filtres & géographie

Le filtre location[].city est ignoré par le moteur. Utilisez postalCode, inseeCode ou department. Voir Recherche géographique.
Le tableau location[] accepte plusieurs entrées combinées en OR. Mélangez codes postaux, INSEE, départements et bbox/distance dans une même requête.
  • geoBoundingBox : pour des zones administratives ou rectangulaires (carte, secteur agence). Contraintes : topLeft.lat > bottomRight.lat et topLeft.lon < bottomRight.lon.
  • geoDistance : pour un rayon autour d’un point (recherche client, point de vente). distanceKm > 0 obligatoire.

​
Billing & support

Endpoint dédié : GET /v2/protected/consumption. Le dashboard my.fluximmo.io affiche aussi un récapitulatif.
Certains endpoints de niche (Market analytics avancé, Properties analytics avancé, Agences, etc.) ne figurent pas dans la documentation publique par défaut. Ils peuvent être ajoutés à votre clé sur demande, ou faire l’objet d’un sur-mesure (devis). Détails dans la matrice des capabilities.
[email protected] — incluez votre clientId, l’endpoint concerné, un exemple de requête et la réponse reçue.

Clé test gratuite — 1 semaine

Créez un compte sur my.fluximmo.io pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement, aucun appel commercial.