API Documentation

Integrate our lossless upload engine programmatically.

← Back Home

You can also retrieve this documentation in JSON format at /api/help.

POST /api/upload

Upload a single file with client-side AES-256-GCM encryption and instant duplicate detection.

Headers

Content-Type: application/json

Body Parameters

{
  "filename": "image.png",
  "content": "...", // Base64 encoded AES-256-GCM ciphertext (IV 12B + Ciphertext + Tag 16B)
  "encrypted": true, // Required: true
  "rawHash": "a1e4e277...", // (Recommended) Hex SHA-256 of the unencrypted file for instant duplicate detection
  "pHash": null // (Optional) Perceptual hash
}

Responses

200 OK: {"success": true, "url": "https://.../public/00a83ad20c78.png", "cached": false}

409 Conflict (Duplicate): File already exists. Returns existing file URL instantly without uploading. {"success": true, "cached": true, "url": "..."}

413 Payload Too Large: Over 24MB limit.

415 Unsupported Media Type: Executable files blocked.

POST /api/batch-upload

Upload multiple files efficiently in one single Git commit.

Body Parameters

{
  "files": [
    { "filename": "1.png", "content": "...", "encrypted": true, "rawHash": "..." },
    { "filename": "2.png", "content": "...", "encrypted": true, "rawHash": "..." }
  ]
}

Responses

200 OK: {"success": true, "results": [{"filename": "1.png", "url": "...", "cached": false}]}

POST /api/album/create

Create a shareable collection/album link for multiple uploaded files.

Body Parameters

{
  "files": ["f00d8734c00b.pdf", "00a83ad20c78.png"]
}

Responses

200 OK: {"success": true, "albumId": "...", "url": "https://.../folder.html?album=..."}

Developer Tools

Integrate our services easily using our official developer tools.

Python dr-fast-upload.py
⬇️ Download Script

A command-line interface for uploading files directly from your terminal with end-to-end encryption.

Quick Download (Terminal)

curl -O https://dr-fast-upload.pages.dev/dev-tools/dr-fast-upload.py

Usage

pip install cryptography
python dr-fast-upload.py myfile.jpg
python dr-fast-upload.py "C:\Users\Bob\Documents\image.png"
JavaScript iframe.js
⬇️ Download Widget

An embeddable Drag & Drop upload widget for websites and web applications with native in-browser encryption.

Direct Embed

<!-- Add to your HTML -->
<div id="dr-upload-widget"></div>
<script src="https://dr-fast-upload.pages.dev/dev-tools/iframe.js"></script>