> ## Documentation Index
> Fetch the complete documentation index at: https://docs.immoteur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide : première requête API Immoteur

> Créez un token API et envoyez une première requête vérifiée à l’API publique Immoteur

Utilisez ce guide pour vérifier que votre token fonctionne et consulter les data access disponibles pour votre intégration.

<Steps>
  <Step title="Créez un token API">
    Dans le dashboard Immoteur, ouvrez **Settings → API tokens** et créez un token. Ne le placez pas dans votre code source. Consultez [Tokens API et accès aux données](./configuration) pour les étapes dans le dashboard.
  </Step>

  <Step title="Stockez le token localement">
    Définissez `IMMOTEUR_TOKEN` dans votre shell ou votre secret store avant d’envoyer des requêtes.

    ```bash theme={null}
    export IMMOTEUR_TOKEN='YOUR_TOKEN'
    ```
  </Step>

  <Step title="Appelez l’endpoint d’authentification">
    Envoyez `GET /auth` avec le token Bearer. Les requêtes suivantes sont équivalentes.

    <CodeGroup>
      ```bash cURL theme={null}
      curl --fail-with-body --show-error --silent \
        'https://api.immoteur.com/public/v1/auth' \
        -H "Authorization: Bearer $IMMOTEUR_TOKEN"
      ```

      ```javascript JavaScript theme={null}
      const response = await fetch('https://api.immoteur.com/public/v1/auth', {
        headers: { Authorization: `Bearer ${process.env.IMMOTEUR_TOKEN}` },
      });

      if (!response.ok) throw new Error(`HTTP ${response.status}`);
      const account = await response.json();
      ```

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

      response = requests.get(
          "https://api.immoteur.com/public/v1/auth",
          headers={"Authorization": f"Bearer {os.environ['IMMOTEUR_TOKEN']}"},
          timeout=10,
      )
      response.raise_for_status()
      account = response.json()
      ```
    </CodeGroup>
  </Step>

  <Step title="Vérifiez le résultat et choisissez la suite">
    Une réponse réussie est `200 OK` et contient les métadonnées du token ainsi que `meta.dataAccessLimit`. Ensuite, [choisissez une ressource API](./ressources-api) pour récupérer des données ou [configurez les webhooks](./webhook) pour recevoir des mises à jour.
  </Step>
</Steps>

Si la requête ne renvoie pas `200`, consultez [Fiabilité de l’API](./fiabilite-api) avant de modifier votre intégration.