Cómo automatizar la entrega de archivos con la REST API de FlingDrop

La REST API de FlingDrop permite a los desarrolladores automatizar la entrega temporal de archivos sin necesidad de una interfaz web. Puedes subir archivos de forma programática, obtener URLs de descarga temporales e integrar el uso compartido de archivos en sistemas CRM, plataformas de comercio electrónico, portales de clientes y herramientas empresariales internas. La API está disponible en el plan Business ($29/mes).

Autenticación

Todas las solicitudes a la API deben incluir tu clave API en el encabezado X-API-Key. Puedes encontrar tu clave API en el panel de control de FlingDrop, o te la enviarán por correo electrónico al registrarte.

X-API-Key: tu_clave_api_aqui

Las claves API están vinculadas a tu cuenta y heredan los límites de tamaño de archivo y vencimiento de tu plan.

Subir un archivo

Envía una solicitud POST al endpoint de subida con el archivo como multipart/form-data:

curl -X POST https://app.flingdrop.com/api/upload \
  -H "X-API-Key: tu_clave_api_aqui" \
  -F "file=@/ruta/a/tu/documento.pdf"

Parámetros:

file (obligatorio): El archivo a subir.

Nota sobre vencimiento: La expiración de los archivos se determina por tu plan. El plan Gratis vence por defecto en 7 días, Business en 30 días y Enterprise en 90 días. Contacta con soporte para personalizar la expiración en cuentas Enterprise.

Respuesta:

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

El campo url es el enlace que compartes con tu destinatario. No requiere inicio de sesión para acceder. El shortCode identifica de forma única el archivo e está incluido en la URL de descarga.

Gestionar archivos

Actualmente, la gestión de archivos está disponible a través del panel de control de FlingDrop. La API se centra en subir archivos y generar enlaces compartibles. Para revocar el acceso a un archivo o ver el historial de subidas, inicia sesión en tu panel de control.

Próximamente: Es posible que se agreguen endpoints de listado y eliminación de archivos en una versión futura. Suscríbete a nuestro blog de desarrolladores para obtener actualizaciones.

Patrones de integración comunes

1. CRM: Envío automático de propuesta en PDF tras la creación de un negocio

Cuando se crea un nuevo negocio en tu CRM, activa un webhook que sube la plantilla de propuesta y envía al cliente un enlace de descarga por correo electrónico — sin necesidad de adjuntar archivos manualmente.

import requests

def enviar_propuesta(email_cliente, ruta_pdf):
    with open(ruta_pdf, 'rb') as f:
        response = requests.post(
            'https://app.flingdrop.com/api/upload',
            headers={'X-API-Key': 'tu_clave_api_aqui'},
            files={'file': f}
        )
    data = response.json()
    if data['success']:
        download_url = data['data']['url']
        # envía download_url al email_cliente a través de tu servicio de correo
        return download_url
    else:
        print(f"La subida falló: {data['error']['message']}")
        return None

2. Comercio electrónico: Entrega de productos digitales después de la compra

Tras la confirmación de un pago exitoso mediante webhook de Stripe, el servicio de cumplimiento de pedidos sube el archivo digital comprado (licencia de software, ebook, recurso de diseño) a FlingDrop y envía al cliente un enlace de descarga de 90 días.

3. Herramientas internas: Distribución de informes nocturnos

Programa un trabajo cron que suba informes generados cada noche y envíe enlaces de descarga a los interesados. Los enlaces vencen después de 7 días, manteniendo el almacenamiento limpio automáticamente.

#!/bin/bash
ARCHIVO_INFORME="/var/reports/diario-$(date +%Y%m%d).pdf"
RESPUESTA=$(curl -s -X POST https://app.flingdrop.com/api/upload \
  -H "X-API-Key: $FLINGDROP_API_KEY" \
  -F "file=@$ARCHIVO_INFORME")
DOWNLOAD_URL=$(echo $RESPUESTA | jq -r '.data.url')
# envía $DOWNLOAD_URL a tu sistema de notificaciones

Referencia de límites por plan

Plan	Tamaño máximo de archivo	Rango de vencimiento	Pool mensual
Business ($29/mes)	10 GB	1–90 días	500 GB/mes

Límites de velocidad

Las solicitudes a la API están sujetas a límites de velocidad a nivel de plan. Si se superan los límites, se devuelve una respuesta 429 Too Many Requests con un encabezado Retry-After que indica cuándo se restablece el límite.

Primeros pasos

Crea una cuenta en FlingDrop en flingdrop.com (registro gratuito).
Actualiza al plan Business desde tu panel de control.
Copia tu clave API desde el panel de control.
Realiza tu primera solicitud de subida utilizando los ejemplos anteriores.

Guías relacionadas: