Préproduction : l'API répond sur https://api.visiobank.com/v1, avec une clé de test. Les exemples gardent l'adresse de production, api.vizalia.ai, qui ouvrira à la mise en production.

Photos, vidéos, documents et mesures

Pendant l’appel, le conseiller ou l’agent prend des photos, filme, partage des documents et mesure. Chaque média a son événement et sa liste.

Média	Événement	Liste
Photo	`photo.created`	`GET /sessions/{session_id}/photos`
Vidéo	`video.ready`, quand le clip est téléchargeable	`GET /sessions/{session_id}/videos`
Document	`document.signed`, quand il est signé	`GET /sessions/{session_id}/documents`
Mesure	`measurement.created`	`GET /sessions/{session_id}/measurements`

Les listes demandent la portée sessions:read. Elles ne se paginent pas : chacune renvoie tous les médias de la session, avec has_more à faux.

Ce que dit chaque média

Photo : caption est sa légende, hd dit si elle a été prise en haute définition, location sa position, nulle sans l’option géolocalisation de l’espace.
Vidéo : source dit qui a déclenché le clip (client, conseiller ou agent IA). Le clip passe par starting, active et ending, puis finit en complete ou en failed ; son url n’existe qu’à complete, ce qu’annonce video.ready.
Document : sent et downloaded disent s’il a été remis au client et récupéré. signed dit que le client a validé son code de signature ; faux sur un document sans signature_required, il veut dire « n’avait pas à être signé ». document.signed part à la signature.
Mesure : largeur, hauteur et profondeur en mètres (width_m, height_m, depth_m), chacune avec son incertitude en pourcentage (width_ci_pct…) quand elle est connue, et surface en m² (area_m2). label est son libellé ; snapshot_url, l’image de la mesure, est nulle si l’espace interdit le téléchargement, comme l’URL d’une photo.

Télécharger un fichier

L’url d’un média est une URL signée : elle s’ouvre sans votre clé, et expire au bout d’une heure. Le type du fichier est dans l’en-tête Content-Type de la réponse.

Téléchargez le fichier dès réception et rangez-le chez vous : ne stockez ni ne relayez l’URL.
Pour une URL neuve, relisez la liste.
L’URL est nulle quand l’espace interdit le téléchargement.