Cette page rassemble toutes les bornes — payload, quotas, rate limits — utiles pour dimensionner votre intégration.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.
Limites payload
Bornes statiques validées côté API. Un dépassement renvoie400 avec error.code = 10002 ou 10003.
| Limite | Valeur |
|---|---|
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.lat | doit être > bottomRight.lat |
geoBoundingBox.topLeft.lon | doit être < bottomRight.lon |
location[] | combinable (postalCode + insee + department + bbox/distance dans un OR) |
Rate limits
| Type de clé | Cadence indicative |
|---|---|
| Clé test | ~5 req/s |
| Clé production starter | ~15 req/s |
| Clé production custom | 50+ req/s sur devis selon volume |
- 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é test | 1 semaine | Quotas 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é production | Selon contrat | Activé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, aucun appel commercial.
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/consumption
Le dashboard my.fluximmo.io affiche également un récapitulatif (jour, mois, par endpoint).
Que faire en cas de dépassement ?
429: appliquer le backoff, ralentir la cadence.- Quota mensuel atteint : les requêtes peuvent être rejetées. Contacter le support pour augmenter le quota.
- Endpoint non activé (
403) : demander l’activation via [email protected].