MeshStream

Stream 3D mesh data (GLB format) to the Qonic viewer in real-time.

GET https://api.qonic.com/v1/mesh-stream/upload-url

Get mesh upload URLs

Generates one or more pre-signed URLs for uploading GLB mesh files. Use these URLs to upload mesh data before streaming it to the viewer.

Query parameters

  • Name
    count
    Type
    integer
    Required
    Optional
    Description
    Number of upload slots to generate (1–100, default 1).

Response fields

  • Name
    items
    Type
    array<object>
    Required
    Optional
    Description
    One pre-signed upload slot per requested item. Length matches the count query parameter (1–100, default 1).

Error responses

  • Name
    401
    Type
    error
    Description
    Authentication required. Provide a valid Bearer token in the Authorization header.
  • Name
    403
    Type
    error
    Description
    Insufficient permissions for this operation

POST https://api.qonic.com/v1/mesh-stream

Stream meshes to viewer

Sends one or more GLB meshes to the 3D viewer in real-time via SignalR. Each item may carry inline base64-encoded GLB data, or a prior upload key. Items in a batch are dispatched concurrently; arrival order at the viewer is not guaranteed. Use separate batches if ordering matters. All-or-nothing validation: if any item is invalid, the entire request is rejected with 400 and no items are dispatched.

Error responses

  • Name
    400
    Type
    error
    Description
    Invalid request parameters or body
  • Name
    401
    Type
    error
    Description
    Authentication required. Provide a valid Bearer token in the Authorization header.
  • Name
    403
    Type
    error
    Description
    Insufficient permissions for this operation