---
title: "Api V1 Cao Integrite"
method: POST
path: "/api/v1/cao/integrite"
tags: ["api-ia", "api-ia"]
---

# Api V1 Cao Integrite

`POST /api/v1/cao/integrite`

## Request

- Base URL: `https://synergieloc.fr`
- URL: `https://synergieloc.fr/api/v1/cao/integrite`
- Auth: API key in header `X-API-Key`

CONTRÔLE D'INTÉGRITÉ de la construction — GRATUIT, sans clé API.

Répond à une seule question : le bâtiment est-il réellement **clos et
couvert** ? Ce sont les défauts qu'on ne voit qu'en confrontant les éléments
entre eux, et qui ne se remarquent sinon qu'une fois la vidéo rendue :

  · `enveloppe_percee` — une extrémité de mur ne rejoint rien. Les jonctions
    en T et les jambages de porte sont reconnus : pas de fausse alerte.
  · `bande_ouverte_entre_niveaux` / `niveaux_qui_se_recouvrent`
  · `mur_etage_sans_appui` — un mur d'étage qui flotte
  · `toit_ouvert` — des murs du dernier niveau sous aucune toiture
  · `toiture_sous_les_murs` — le toit tranche le bâtiment
  · `ouvertures_chevauchantes`
  · `murs_composantes_isolees` — îlots de murs jointifs mais détachés de la
    maison (piliers, murets, « murs en vrac ») : l'enveloppe principale est
    close, pourtant l'extérieur est un chantier. `propose: null` = retirer.
  · `murs_hors_racine` — des murs égarés sous une autre clé (`niveaux[]`…) :
    rien ne serait contrôlé, la scène passerait pour valide à tort

Et surtout, il AIDE À CORRIGER : `correctifs[]` désigne le champ exact et la
valeur à y écrire — `{"cible":"murs[3].x2","actuel":10400,"propose":11000,
"raison":"souder sur murs[4].x1 (écart 600 mm)"}`, ou
`{"cible":"murs[12]","propose":null}` pour retirer un mur en vrac. Quand deux
extrémités sont libres l'une en face de l'autre, la soudure est proposée au
MILIEU, pour que les correctifs restent applicables ensemble.

Body : la scène CAO (GET /cao/schema), plus deux options :
  - `appliquer: true`  → renvoie aussi `scene_corrigee` (scène patchée) et
    `diff` (liste `{cible, actuel, propose, raison}` — un par correctif
    réellement appliqué, pour savoir CE QUI a bougé sans comparer
    manuellement `scene_corrigee` au JSON envoyé, ex. reprendre le
    mobilier autour d'un escalier déplacé) ;
  - `revalider: true`  → et le contrôle rejoué dessus, pour vérifier d'un
    seul appel que la correction ferme bien le bâtiment.

Conçu pour être appelé souvent : indexation spatiale, quelques millisecondes
sur des scènes de plusieurs centaines de murs (`duree_ms` dans la réponse).

## Request body

- object

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/synergieloc/apis/synergieloc-api-immobiliere-pour-les-ia.md) · [All operations](https://skmtc.dev/synergieloc/apis/synergieloc-api-immobiliere-pour-les-ia/llms.txt) · [OpenAPI document](https://skmtc.dev/synergieloc/apis/synergieloc-api-immobiliere-pour-les-ia/revisions/6af072bd388f?raw)