Upstream file via stream auth

Overview

Upload large files or data streams to a separate streaming server using authenticated streaming. This method is suitable for large payloads that are impractical to send via direct data exchange.

Upstream File via Stream Auth

Endpoint: POST /

Authentication: Required (Stream authentication token as query parameter)

Query Parameters

Parameter	Type	Required	Description
`auth`	string	Yes	Upstream authentication token obtained from retrieve temporary data token

Request

The request body contains the file or data stream to upload.

Full URL Format:

{stream_server_id}:{stream_server_port}/?auth={stream_authentication_token}

Use Case

Use this endpoint for streaming large files directly to the storage infrastructure. The streaming server details (stream_server_id, stream_server_port) and authentication token (auth) are provided in the response from the retrieve temporary data token endpoint.

This method supports progressive upload without loading entire files into memory, making it efficient for large files or bandwidth-constrained environments. After successful upload, the data is encrypted by Privicore and routed to devices, completing the token exchange process.

Stream authentication token is single-use and tied to the specific token reservation
Upload must complete before the token's TTL expires
The streaming server may be separate from the main Privicore API server
After successful upload, the temporary token becomes permanent

Responses

🟢200Success

application/json

Upload status for each chunk of the file.

Body

Example

[
    {
        "chunk": 0,
        "streamSize": 0,
        "received": 0,
        "name": "string",
        "context": "string",
        "started": "2019-08-24T14:15:22Z",
        "current": "2019-08-24T14:15:22Z",
        "delta": 0
    }
]

🟠400400

Upstream file via stream auth

Overview#