Export, import et clonage

Export / import synchrones

POST /api/rooms/:roomId/export      (token permission: read)    # empty body {} = full room → .gpkg
POST /api/rooms/:roomId/import       (token permission: write)   # multipart file=@room.gpkg, ≤ 2 GiB

curl -X POST "$API/api/rooms/$ROOM/export" -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{}' -o room.gpkg
curl -X POST "$API/api/rooms/$ROOM/import" -H "Authorization: Bearer $TOKEN" -F "file=@room.gpkg"

Le corps et la requête d’export reflètent les options de l’application (?include_tiffs=&include_tiles=).

Sonde de taille

GET /api/rooms/:roomId/export-size      (token permission: read)

→ { "bytes", "thresholdBytes", "recommended": "sync" | "async" }. Utilisez-la pour choisir entre la voie synchrone et les tâches asynchrones (l’application bascule automatiquement au-delà de ~2 Gio).

Tâches d’export asynchrones

POST /api/rooms/:roomId/export-jobs                 (read)   → 202 { "jobId": "<uuid>" }
GET  /api/rooms/:roomId/export-jobs/:jobId          (read)   → { status, bytes, error?, startedAt, finishedAt }
GET  /api/rooms/:roomId/export-jobs/:jobId/artifact (read)   → .gpkg stream

Les identifiants de tâche sont liés à leur salle (interroger la tâche d’une autre salle → 404). Les artefacts expirent au bout de 24 heures.

Cloner une grande salle (manifeste de reconnexion)

Les très grandes salles dépassent le plafond d’import de 2 Gio : elles sont donc clonées plutôt que réenvoyées — le serveur copie les données sous-jacentes sur place.

GET  /api/rooms/:roomId/export-manifest     (read)    # small .json — no bulk data inside
POST /api/rooms/:roomId/clone-jobs           (write)   → 202 { "jobId": "job-<uuid>" }
GET  /api/layers/jobs/:jobId                            # poll: { stage, progress, layersCloned, ... }

Le manifeste transporte les repères, les icônes, les formes dessinées et les configurations de couches ; les données volumineuses des couches sont référencées uniquement par l’identifiant de la salle source et copiées côté serveur dans la salle cible. Les octets copiés sont décomptés du quota de stockage du propriétaire cible.