Documentation API
Référence API Homlytic
Intégrez les analyses immobilières Homlytic dans vos propres applications. Toutes les requêtes passent par Firebase Cloud Functions et requièrent un token JWT Firebase.
Authentification
Chaque requête doit inclure un token Firebase ID dans le header Authorization. Obtenez le token depuis le SDK Firebase Authentication :
import { getAuth } from "firebase/auth";
const auth = getAuth();
const token = await auth.currentUser?.getIdToken();
// Inclure dans chaque requête :
fetch(ENDPOINT_URL, {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": `Bearer ${token}`,
},
body: JSON.stringify(payload),
});URL de base
Toutes les Cloud Functions sont accessibles via :
https://europe-west1-{PROJECT_ID}.cloudfunctions.net/{functionName}La variable d'environnement NEXT_PUBLIC_FUNCTIONS_URL pointe vers la bonne région pour votre déploiement.
Limites de débit
Plan Gratuit
10 analyses / compte
Tokens offerts à l'inscription
Plan Essentielle / Complète
60 req/mois
Par token acheté
Plan Pro
500 req/mois
Analyses illimitées incluses
Endpoints
Codes d'erreur
Format de réponse d'erreur : { error: string, code?: string }
400Bad RequestParamètre manquant ou invalide. Vérifiez le corps de la requête.
401UnauthorizedToken Firebase manquant ou expiré. Reconnectez-vous et réessayez.
403ForbiddenPlan insuffisant pour cet endpoint ou tokens épuisés.
404Not FoundRessource introuvable (ex: analysisId inconnu).
429Too Many RequestsLimite de débit atteinte. Plan Pro : 500 req/mois, plans à l'unité : 60 req/mois.
500Internal Server ErrorErreur serveur interne. Réessayez dans quelques secondes.
Accès API avancé
Intégration professionnelle
Le plan Pro inclut 500 requêtes API/mois. Pour des besoins de volume supérieur (agents immobiliers, promoteurs, plateformes), contactez-nous pour une offre sur mesure avec webhook Stripe, SLA et support dédié.
Contactez-nous →