Skip to main content
Cette page rassemble toutes les bornes — payload, quotas, rate limits — utiles pour dimensionner votre intégration.

​
Limites payload

Bornes statiques validées côté API. Un dépassement renvoie 400 avec error.code = 10002 ou 10003.
LimiteValeur
search.size (full search)1 à 100
search.size (lite search)1 à 25
search.keywords[]max 20 items
search.fullTexts[]max 20 items
geoDistance.distanceKm> 0 (sinon erreur)
geoBoundingBox.topLeft.latdoit être > bottomRight.lat
geoBoundingBox.topLeft.londoit être < bottomRight.lon
location[]combinable (postalCode + insee + department + bbox/distance dans un OR)
Le filtre location[].city est ignoré par le moteur. Utilisez postalCode, inseeCode ou department. Voir Recherche géographique.

​
Rate limits

Type de cléCadence indicative
Clé test~5 req/s
Clé production starter~15 req/s
Clé production custom50+ req/s sur devis selon volume
Comportement en cas de dépassement :
  • HTTP 429 Too Many Requests
  • Header Retry-After (en secondes) lorsque applicable — à respecter
  • En l’absence de Retry-After, appliquer un backoff exponentiel + jitter (voir Bonnes pratiques)
Pour ajuster votre cadence (gros batch, montée en charge, contrainte temps réel), écrivez à [email protected] avec votre clientId et votre besoin.

​
Quotas par type de clé

Type de cléValiditéPérimètre
Clé test1 semaineQuotas réduits, suffisants pour découverte, POC et validation d’intégration. Accès complet aux modules Analytics, IA, Géocodage. Seule restriction : création d’alertes webhook sur demande (par mail à [email protected]).
Clé productionSelon contratActivée depuis l’espace client my.fluximmo.io. Pas d’engagement initial, pas de paiement avant validation de votre intégration. Pricing au volume.

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 requis.

​
Endpoints non publics par défaut

Certains endpoints de niche ne sont pas exposés publiquement par défaut. Ils peuvent être ajoutés à votre clé sur demande, ou faire l’objet d’un sur-mesure (devis). Détails : Capabilities sur demande.

​
Suivi de consommation

L’endpoint dédié donne votre consommation en temps réel : GET /v2/protected/admin/consumption Le dashboard my.fluximmo.io affiche également un récapitulatif (jour, mois, par endpoint).
Branchez l’endpoint consumption à votre monitoring pour lever une alerte avant d’atteindre 80% du quota mensuel.

​
Que faire en cas de dépassement ?

  1. 429 : appliquer le backoff, ralentir la cadence.
  2. Quota mensuel atteint : les requêtes peuvent être rejetées. Contacter le support pour augmenter le quota.
  3. Endpoint non activé (403) : demander l’activation via [email protected].
Voir Codes d’erreur pour la gestion fine.