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.
Le filtre location[].city est ignoré par le moteur. Utilisez postalCode, inseeCode ou department. Voir Recherche géographique.

Rate limits

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é

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.