---
title: "Api V1 Cao Visite Camera"
method: POST
path: "/api/v1/cao/visite/camera"
tags: ["api-ia", "api-ia"]
---

# Api V1 Cao Visite Camera

`POST /api/v1/cao/visite/camera`

## Request

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

PILOTER la caméra : une séquence d'actions → un nouveau point de vue.

La visite calculée est une chorégraphie complète ; cet endpoint sert à
REPRENDRE LA MAIN sur une vue précise — recadrer une façade, monter voir le
faîtage, entrer dans la pièce d'à côté — sans réécrire un chemin à la main.

Body :
  - la scène CAO (`murs`, …, cf. GET /cao/schema) — OPTIONNELLE mais vivement
    conseillée : c'est elle qui apporte la détection de murs (un pas qui
    entrerait dans une cloison est refusé et signalé) et les repères de pièces ;
  - `depuis` : {position, vise, focale_mm} — le point de vue de départ, tel
    qu'il sort de `chemin` dans /cao/visite/plan. Absent : vue d'ensemble du
    bâtiment (ou hauteur d'œil à l'origine si la scène manque) ;
  - `actions` : la séquence, en codes (`avancer`) ou en touches (`ctrl+8`),
    avec répétitions (`"avancer x3"` ou `{code:"avancer", repetitions:3}`) ;
  - `reglages` : pas_mm, pas_altitude_mm, pas_rotation_deg, facteur_zoom,
    focale_min_mm, focale_max_mm, grand_pas.

Retourne l'état final, l'état après CHAQUE action (avec le motif des pas
refusés), et un `chemin` prêt à être rendu en 4K par /cao/visite/studio.
Catalogue des actions (gratuit) : GET /api/v1/cao/visite/commandes.

## Headers

- `x-api-key` string

## 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)