UPLOAD NODE DOCUMENTATION

● INACTIVE | 02/20/2025 14:32:15 UTC
Node ID: Node-CH-01 Region: eu-central-1 Last Check: 2025-02-20 14:32:15 UTC

File Ingestion Service

This node facilitates secure file uploads via PUT/POST endpoints. All uploads are channeled through the central gateway for validation before processing.

Supported Content Types

Maximum Payload Size

500MB per individual request (chunked upload enabled)

MIME Types

application/pdf, image/png, image/jpeg, application/vnd.ms-excel, text/csv

Session Headers

X-Upload-Session-ID: required for multi-part transfers

Authentication Requirements

All requests must include valid API key in the X-API-Key header. Failed authentication returns 401 Unauthorized.

// Initialize chunked upload session
curl -X POST https://upload.ventocloud.online/api/upload/init -H "Content-Type: multipart/form-data"
-H "X-API-Key: sk_live_a1b2c3d4e5f6"
-H "X-Upload-Session-ID: session_7f8a9b0c"
-F "file=@/path/to/document.pdf"
-F "chunk=@/path/to/data.bin"
// Response: { "session_id": "7f8a9b0c", "chunk_size": 5242880 }

Response Codes

HTTP Status Condition Description
200 OK Upload Complete File processed successfully
202 Accepted Asynchronous Processing Job queued for background processing
400 Bad Request Invalid Payload Invalid content type or size
413 Payload Too Large Size Exceeded Payload exceeds 500MB limit

Session Management

Each upload session is valid for 4 hours. Expired sessions require re-initialization.