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

# Authentification API Fluximmo — clé x-api-key

> Authentification par header `x-api-key`. Activation et gestion des clés via my.fluximmo.io.

Toutes les requêtes vers les endpoints `/v2/protected/*` requièrent une clé API transmise via le header HTTP `x-api-key`. Les endpoints `/v2/sample/*` sont publics et n'exigent aucun header.

## Header `x-api-key`

Ajoutez votre clé dans chaque requête authentifiée :

<CodeGroup>
  ```bash curl theme={null}
  curl --location 'https://api.fluximmo.io/v2/protected/admin/consumption?from_date=2024-01-01&to_date=2024-02-01' \
    --header 'x-api-key: VOTRE_CLE'
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.fluximmo.io/v2/protected/admin/consumption",
      headers={"x-api-key": "VOTRE_CLE"},
      params={"from_date": "2024-01-01", "to_date": "2024-02-01"},
  )
  ```

  ```javascript Node theme={null}
  const response = await fetch(
    "https://api.fluximmo.io/v2/protected/admin/consumption?from_date=2024-01-01&to_date=2024-02-01",
    { headers: { "x-api-key": "VOTRE_CLE" } }
  );
  ```
</CodeGroup>

Si la clé est absente, invalide ou expirée, l'API renvoie un `401 Unauthorized` (clé manquante / inconnue) ou `403 Forbidden` (clé valide mais sans accès au périmètre demandé). Détail des codes : [Codes d'erreur](/ressources/codes-erreur).

## Clé test gratuite (1 semaine)

<Card title="Générer une clé test sur my.fluximmo.io" icon="key" href="https://my.fluximmo.io">
  Onglet **API** → **Générer une clé test**.
</Card>

**Limites de la clé test :**

* Durée : **7 jours** à compter de la génération
* Volume : quotas réduits (\~5 req/s — suffisants pour valider une intégration de bout en bout)
* Périmètre : accès complet aux modules **Search, Refetch, Analytics, IA, Géocodage**
* Seule restriction : **création d'alertes webhook sur demande** par mail à [contact@fluximmo.com](mailto:contact@fluximmo.com)

Pour découvrir l'API sans même créer de compte, utilisez d'abord les [endpoints sample no-auth](/demarrer/sample-data).

## Clé production

Activation **depuis votre espace client** [my.fluximmo.io](https://my.fluximmo.io) — onglet **API**. Vous pilotez tout depuis votre compte avant ou après activation : génération de clé, suivi de consommation, paramétrage facturation.

* Pas d'engagement initial, pas de paiement avant que votre intégration soit validée
* Pricing au volume — barème détaillé sur l'espace client
* Pour des besoins spécifiques (gros volume, endpoints custom, devis sur-mesure), écrivez à [contact@fluximmo.com](mailto:contact@fluximmo.com) avec votre `clientId`

<Info>
  **Vous êtes une startup early-stage ?** Fluximmo accompagne les jeunes équipes avec des conditions adaptées au cas par cas. [Nous contacter](mailto:contact@fluximmo.com).
</Info>

<Card title="Clé test gratuite — 1 semaine" icon="key" href="https://my.fluximmo.io">
  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.
</Card>