Construye con FlingDrop

Inicio rápido

1. 1

   Crea una cuenta gratis

   Regístrate en app.flingdrop.com — toma 30 segundos.

2. 2

   Obtén tu API Key

   Tu API Key se envía por email al registrarte. También puedes generar nuevas keys desde tu dashboard en Configuración > API Keys.

3. 3

   Sube tu primer archivo

   Usa el comando cURL a continuación para subir un archivo y obtener un enlace para compartir.

   curl -X POST https://app.flingdrop.com/api/upload \
     -H "X-API-Key: YOUR_API_KEY" \
     -F "file=@document.pdf"

URL base y autenticación

Todas las solicitudes API van a:

https://app.flingdrop.com

Autentifica cada solicitud incluyendo tu API Key en el header X-API-Key:

X-API-Key: your_api_key_here

Tu API Key se envía por email al registrarte. También puedes crear nuevas keys desde tu dashboard.

Formato de respuesta

Todos los endpoints devuelven JSON con una estructura consistente:

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "..."
  }
}

Subir un archivo

POST /api/upload

Sube un archivo único usando multipart form data. El servidor detecta automáticamente duplicados por hash del archivo — si el mismo archivo ya fue subido y no ha expirado, se retorna la URL existente sin almacenar una segunda copia.

Headers

Body

multipart/form-data con un campo llamado file.

Respuesta

{
  "success": true,
  "data": {
    "url": "https://app.flingdrop.com/f/abc123xyz",
    "shortCode": "abc123xyz",
    "fileName": "document.pdf",
    "fileSize": 2048576,
    "expiresAt": "2026-04-01T00:00:00Z",
    "isDuplicate": false
  }
}

Cuando isDuplicate es true, no se almacenó un archivo nuevo — se retorna el enlace de descarga existente.

Upload por partes (chunked)

Para archivos grandes, usa upload chunked para dividir la transferencia en múltiples solicitudes. Esto evita timeouts y permite tracking de progreso.

{
  "fileName": "large-video.mp4",
  "totalSize": 524288000,
  "fileHash": "A1B2C3...",
  "isCompressed": false,
  "originalSize": 524288000
}

{
  "success": true,
  "data": {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "isDuplicate": false
  }
}

{
  "success": true,
  "data": {
    "bytesReceived": 10485760,
    "chunksReceived": 1
  }
}

Verificar duplicado

GET /api/check/{hash}

Verifica si un archivo con el hash SHA-256 dado ya existe en tu tenant. Útil para evitar subir un archivo que ya está disponible.

Respuesta

{
  "success": true,
  "data": {
    "exists": true,
    "url": "https://app.flingdrop.com/f/abc123xyz",
    "expiresAt": "2026-04-01T00:00:00Z"
  }
}

Cuando exists es false, url y expiresAt son null.

URLs de descarga

Cada archivo subido obtiene una URL corta con el formato:

https://app.flingdrop.com/f/{shortCode}

Estas URLs son públicas — no se necesita autenticación para descargar. Cualquiera con el enlace puede descargar el archivo hasta que expire.

La expiración depende del plan del tenant: 7 días (Free), 30 días (Pro) o 90 días (Business). Después de la expiración, el archivo se elimina permanentemente.

Health check

GET /api/status

Verifica que la API está operativa. No requiere autenticación.

{
  "success": true,
  "data": {
    "status": "OK",
    "serverTime": "2026-03-23T12:00:00Z"
  }
}

Invitaciones de equipo

Los tenants del plan Business pueden invitar miembros de equipo vía la API. Las invitaciones se envían por email y expiran después de 7 días.

{
  "email": "colleague@company.com",
  "role": "Member",
  "tenantId": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "success": true,
  "token": "...",
  "invitationUrl": "https://app.flingdrop.com/invitation/...",
  "message": "Invitation created successfully"
}

{
  "success": true,
  "tenantName": "Acme Corp",
  "email": "colleague@company.com",
  "role": "Member",
  "expiresAt": "2026-03-30T00:00:00Z"
}

{
  "password": "securepassword123",
  "name": "Jane Doe"
}

Códigos de error

Todas las respuestas de error incluyen un campo code legible por máquina:

Límites de tasa

Los endpoints de upload tienen límites de tasa. Cuando excedes el límite, recibes una respuesta HTTP 429 Too Many Requests con un header Retry-After indicando cuántos segundos esperar.

Implementa backoff exponencial en tu cliente para manejar los límites de tasa de manera elegante.

Límites por plan

Cada plan tiene límites específicos que la API aplica automáticamente:

Ejemplos de código

# Subir un archivo
curl -X POST https://app.flingdrop.com/api/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf"

# pip install requests
import requests

response = requests.post(
    "https://app.flingdrop.com/api/upload",
    headers={"X-API-Key": "YOUR_API_KEY"},
    files={"file": open("document.pdf", "rb")},
)

data = response.json()
if data["success"]:
    print(f"Download URL: {data['data']['url']}")
    print(f"Expires at:   {data['data']['expiresAt']}")
else:
    print(f"Error: {data['error']['code']} — {data['error']['message']}")

// Node.js (v18+) o navegador
const form = new FormData();
form.append("file", fileInput.files[0]); // browser
// form.append("file", fs.createReadStream("document.pdf")); // Node.js

const res = await fetch("https://app.flingdrop.com/api/upload", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: form,
});

const { success, data, error } = await res.json();
if (success) {
  console.log("Download URL:", data.url);
  console.log("Expires at:", data.expiresAt);
} else {
  console.error(error.code, error.message);
}

#!/bin/bash
# Subir todos los archivos .log de /var/log/myapp/
API_KEY="YOUR_API_KEY"
DIR="/var/log/myapp/"

for file in "$DIR"*.log; do
  [ -f "$file" ] || continue
  echo "Uploading $file..."
  response=$(curl -s -X POST https://app.flingdrop.com/api/upload \
    -H "X-API-Key: $API_KEY" \
    -F "file=@$file")
  url=$(echo "$response" | grep -o '"url":"[^"]*"' | cut -d'"' -f4)
  echo "  → $url"
done