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

Suivez ce guide pour créer un token, vérifier qu’il fonctionne et connaître les data access disponibles pour votre intégration.

Créez un token API

Dans le dashboard Immoteur, ouvrez API → Tokens et créez un token. Sa valeur n’est affichée qu’une seule fois : enregistrez-la immédiatement dans un gestionnaire de secrets. Ne la placez pas dans votre code source. Consultez Tokens API et accès aux données pour le détail de la configuration.

Stockez le token dans votre environnement local

Définissez IMMOTEUR_TOKEN dans votre shell ou votre gestionnaire de secrets 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.

Démarrer

API

Webhooks

Référence OpenAPI

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