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

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

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 pour les étapes dans le dashboard.

Stockez le token localement

Définissez IMMOTEUR_TOKEN dans votre shell ou votre secret store avant d’envoyer des requêtes.

export IMMOTEUR_TOKEN='YOUR_TOKEN'

Appelez l’endpoint d’authentification

Envoyez GET /auth avec le token Bearer. Les requêtes suivantes sont équivalentes.

curl --fail-with-body --show-error --silent \
  'https://api.immoteur.com/public/v1/auth' \
  -H "Authorization: Bearer $IMMOTEUR_TOKEN"

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();

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()

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 pour récupérer des données ou configurez les webhooks pour recevoir des mises à jour.

Si la requête ne renvoie pas 200, consultez Fiabilité de l’API avant de modifier votre intégration.

Introduction Tokens et accès

Démarrer

API

Webhooks

Référence OpenAPI

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