L’API plan par maison : votre logiciel crée une maison depuis un fichier, la mesure selon la norme et exporte plans, FML ou rapport de mesure.
Il vous faut un compte gratuit pour cela.
API plan : pas à pas
1. Créer une clé de test
Un logement compte une fois par mois, à son premier export ou rapport sans filigrane. Dans Paramètres, API, donnez un nom à la clé et cochez d’abord Clé de test (gratuite) ; cochez ensuite ce qu’elle peut faire (Créer des logements depuis un fichier, Mesurer et exporter des logements, Créer des liens de consultation). Sans Pro, Team ou Enterprise, seule une clé de test peut être créée.
2. Demander l’API
Nous activons l’API par logement pour votre espace de travail ou votre organisation. Les mêmes choix fonctionnent alors pour une clé de production, sans filigrane.
3. Créer un logement
POST /public/v1/homes avec un nom et le fichier en texte : FML, IFC, DXF, .sqm ou le JSON d’un scan RoomPlan. Vos webhooks reçoivent home.ready.
4. Mesurer et exporter
GET /homes/{id}/area mesure selon n’importe quelle norme, gratuitement, par exemple la surface loi Carrez ou la surface habitable (loi Boutin), deux profils à l’état de proposition. GET /homes/{id}/export donne PNG, SVG, PDF, DXF, IFC, FML ou le rapport ; l’en-tête Squaremetry-Home indique si ce logement compte désormais.
5. Renouveler ou révoquer
Renouveler crée une nouvelle clé ; l’ancienne fonctionne encore 24 heures pour que vous puissiez basculer sans interruption. Révoquer arrête une clé aussitôt.
6. Voir ce que cela coûte
GET /public/v1/usage montre les logements de ce mois et ce qu’ils coûtent jusqu’ici, par palier.
Messages que vous pouvez voir
- L’API par logement n’est pas encore activée pour cet espace de travail. Contactez-nous, ou créez une clé de test.
- Choisissez ce que la clé peut faire.