Première requête REST
De zéro à votre première réponse API en moins de 2 minutes.
1
Obtenir une clé API
Créez un compte (Google OAuth, gratuit), puis allez dans Dashboard → Tokens → Créer un token.
# Créez un compte et allez dans Dashboard → Tokens → Créer un token # Copiez votre token (affiché une seule fois) # Exemple de token : normi_abc123...
100 crédits gratuits
Chaque nouveau compte reçoit 100 crédits gratuits. C'est suffisant pour ~20 requêtes de base. Les crédits sont rechargés à 100 le 1er du mois.
2
Faire votre première requête
Remplacez normi_votre_token par votre token et exécutez :
curl "https://mcp.normi.fr/v1/stats/market?code_postal=75001" \ -H "X-API-Key: normi_votre_token"
3
Lire la réponse
Vous devriez recevoir quelque chose comme :
{
"count": 563,
"price": {
"median": 527600,
"avg": 1836728,
"min": 7950,
"max": 122000000
},
"price_per_m2": {
"median": 12301,
"avg": 12835
},
"filters": { "code_postal": "75001" },
"notice": "Applied date_debut=2023-03-11 automatically",
"_credits": { "used": 5, "remaining": 95 },
"query_time_ms": 1025
}price.medianPrix médian en euros pour la zoneprice_per_m2.medianPrix médian au m²_credits.remainingCrédits restants après cette requêtenoticeAparaît si la requête a été auto-limitée (date_debut ajouté automatiquement)Prochaines étapes
En cas d'erreur
- 401 : Clé API manquante ou invalide. Vérifiez le header
X-API-Key. - 400 : Paramètre manquant. Au moins un filtre de localisation est requis sur chaque endpoint.
- 402 : Crédits insuffisants. Achetez des crédits depuis le tableau de bord.