VTX Cloud

API Documentation v1.0.0

All Endpoints

RESTful API for VTX Cloud. Upload, manage, stream files and authenticate users.

🌐
Base URL
cloud.vtx.my.id
📦
Max Upload
100 MB
⚡
Rate Limit
10 req/min
🔐
Auth
Cookie (JWT)
200 SUCCESS4xx CLIENT ERR5xx SERVER ERRGETPOSTDELETE
POST/api/upload

Upload a file to VTX Cloud storage. Files are stored on GitHub-backed storage. Max 100MB. If authenticated, file is linked to your account.

⏱ Rate Limit: 10 requests per minute per IP

Request Body

FieldTypeRequiredDescription
fileFileYesThe file to upload (multipart/form-data)

Responses

200File uploaded successfully
400No file provided
413File size exceeds 100MB limit
429Rate limit exceeded

Code Examples

curl -X POST https://cloud.vtx.my.id/api/upload -F "[email protected]"
GET/api/files
GET/api/files/{filename}
DELETE/api/files/{filename}AUTH
POST/api/auth/register
POST/api/auth/login
POST/api/auth/logout
GET/api/auth/meAUTH
GET/u/{storedName}
GET/embed/{storedName}

📋 File Metadata Schema

FieldTypeDescription
idstringUnique ID (same as storedName)
originalNamestringOriginal filename
storedNamestringStored name (timestamp prefix)
sizenumberSize in bytes
typestringMIME type
uploadedAtstringISO 8601 timestamp
shastringGit SHA hash
uploaderIdstring?User ID (if authenticated)

📊 HTTP Status Codes

CodeMeaningDescription
200OKSuccess
206Partial ContentRange request (streaming)
400Bad RequestInvalid params
401UnauthorizedAuth required
404Not FoundFile not found
413Payload Too LargeExceeds 100MB
429Too Many RequestsRate limited
500Server ErrorInternal error
Powered by VTX Group • API v1.0.0