Upload a normalized RoomPlan scan and its native assets
Die API läuft auf deiner Anwendungsinstanz. Schemas und Feldnamen stammen unverändert aus der OpenAPI-Spezifikation. Browsergebundene Aufrufe benötigen eine Sitzung auf der Instanz.
Requires write scope. The client-generated scan id makes exact retries idempotent. The referenced resource must have type place. RGB keyframes carry ARKit camera poses and intrinsics in the scan's coordinate space; each JPEG part name must match its metadata fileField.
bearerAuthAuthentifizierungBearer <inv_ token>X-Organization-ID?stringOrganization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.
uuidmultipart/form-data- body
id*stringuuidroomResourceId*stringuuidcapturedAt*stringdate-timedeviceModel?stringlength <= 120structureId?stringGroups this room into a building. The first upload may create this id.
uuidstructureName?string1 <= length <= 240coordinateSpaceId?stringShared by rooms captured or relocalized in the same ARKit world frame. Never reuse it for independently captured coordinate systems.
uuidfloorIdentifier?string1 <= length <= 120floorIndex?integer-1000 <= value <= 10000roomIdentifier?string1 <= length <= 120georeference?stringUTF-8 JSON encoding of SpatialGeoreference for this coordinate space.
scene*stringUTF-8 JSON encoding of the RoomScene schema.
worldMap*fileNSSecureCoding archive of the ARWorldMap used for later relocalization.
binarymodel*fileOriginal RoomPlan USDZ mesh.
binarystructureModel?fileOptional combined multi-room USDZ model produced by StructureBuilder.
binaryguideImage?filebinarykeyframes?stringUTF-8 JSON array of at most 32 RoomCameraKeyframeInput records. Each record references one JPEG multipart field named keyframe:.
texturedMesh?fileOptional self-contained, bounded GLB v2 textured room mesh whose vertices are already in the scan's ARKit world frame in metres (model/gltf-binary, maximum 80 MB). External resources, unsafe accessor ranges/counts, oversized embedded textures, and unsupported required codecs are rejected.
binarygaussianSplat?fileOptional bounded binary-little-endian, vertex-only PLY Gaussian Splat whose vertices are already in the scan's ARKit world frame in metres (maximum 80 MB).
binaryExact scan-id replay; no duplicate revision was created
application/json- response
id*stringuuidreplayed*booleancurl -X POST 'https://inventory.example.com/api/v1/room-scans' \ -F 'id=497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -F 'roomResourceId=29c37f2c-728b-44dd-849d-5ffb318c25fb' \ -F 'capturedAt=2019-08-24T14:15:22Z' \ -F 'scene=string' \ -F 'worldMap=string' \ -F 'model=string'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "replayed": true}