Native cURL Philosophy
Many servers in production environments lack Node.js, Python, or package managers. They are minimal container base images or hardened virtual machines. tdrop treats cURL as a tier-1 first-class client. You can drop files, stream archives, and retrieve downloads using nothing more than stock cURL, available on every modern operating system.
API Endpoints Summary
| Method | Endpoint | Description | Content-Type |
|---|---|---|---|
POST |
/upload |
Multipart form-data file upload | multipart/form-data |
POST / PUT |
/upload/raw |
Raw binary byte stream upload | application/octet-stream |
GET / HEAD |
/:code |
Interactive web landing page or curl redirect | text/html |
GET / HEAD |
/:code/:filename |
Direct raw binary file download (supports Range) | Original file MIME type |
GET |
/api/stats |
Public edge telemetry & node metrics | application/json |
1. Multipart Upload: POST /upload
The standard way to upload a local file with form parameters:
$ curl -F "file=@dist.zip" -F "ttl=24h" https://tdrop.link/upload
JSON Response Structure
{
"success": true,
"code": "a7kX9b2",
"filename": "dist.zip",
"size": 4821094,
"sizeFormatted": "4.60 MB",
"url": "https://tdrop.link/a7kX9b2",
"downloadUrl": "https://tdrop.link/a7kX9b2/dist.zip",
"expiresIn": "24h",
"expiresAt": "2026-10-15T18:30:00.000Z",
"qrSvg": "<svg ... />"
}
2. Raw Binary Streaming: POST /upload/raw
When piping stdout directly into cURL, multipart form boundaries are unnecessary. Use the raw stream endpoint with --data-binary @-:
$ cat database.sql | curl -H "X-TDrop-Filename: database.sql" -H "X-TDrop-TTL: 1h" --data-binary @- https://tdrop.link/upload/raw
Custom Request Headers for Raw Uploads
X-TDrop-Filename: The desired download filename (e.g.,build-artifact.tar.gz). Defaults tostdin.txtif omitted.X-TDrop-TTL: Retention duration (1h,24h,7d). Defaults to24h.
3. Resumable Range Downloads: GET /:code/:filename
tdrop supports RFC 7233 partial content range requests. If a large download is interrupted, cURL can resume where it left off:
# The -C - flag tells cURL to automatically determine where to resume
$ curl -C - -O https://tdrop.link/a7kX9b2/dist.zip
4. Useful Shell Aliases
Add these handy functions to your ~/.bashrc or ~/.zshrc for instant terminal shortcuts without installing anything:
# Instant drop alias
drop() {
if [ -z "$1" ]; then
echo "Usage: drop <filename>"
return 1
fi
curl -sF "file=@$1" https://tdrop.link/upload | grep -o 'https://tdrop.link/[^"]*' | head -n 1
}