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 Multipart Example
$ 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 @-:

Streaming Stdin via cURL
$ 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 to stdin.txt if omitted.
  • X-TDrop-TTL: Retention duration (1h, 24h, 7d). Defaults to 24h.

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:

Resume Interrupted Download
# 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:

~/.bashrc / ~/.zshrc
# 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
}