Como Automatizar a Entrega de Arquivos com a REST API do FlingDrop

A REST API do FlingDrop permite que desenvolvedores automatizem a entrega temporária de arquivos sem uma interface web. Você pode fazer upload de arquivos programaticamente, recuperar URLs de download temporárias e integrar o compartilhamento de arquivos em sistemas de CRM, plataformas de e-commerce, portais de clientes e ferramentas empresariais internas. A API está disponível no plano Business ($29/mês).

Autenticação

Todas as requisições à API devem incluir sua API Key no cabeçalho X-API-Key. Você pode encontrar sua API Key no painel do FlingDrop, ou ela é enviada por e-mail quando você se cadastra.

X-API-Key: sua_api_key_aqui

As API Keys têm escopo para a sua conta e herdam os limites de tamanho de arquivo e expiração do seu plano.

Fazendo Upload de um Arquivo

Envie uma requisição POST para o endpoint de upload com o arquivo como multipart/form-data:

curl -X POST https://app.flingdrop.com/api/upload \
  -H "X-API-Key: sua_api_key_aqui" \
  -F "file=@/caminho/para/seu/documento.pdf"

Parâmetros:

• file (obrigatório): O arquivo a ser enviado.

Nota sobre expiração: A expiração do arquivo é determinada pelo seu plano. O plano Gratuito expira por padrão em 7 dias, Business em 30 dias e Enterprise em 90 dias. Entre em contato com o suporte para personalizar a expiração em contas Enterprise.

Resposta:

{
  "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
  }
}

O campo url é o link que você compartilha com o destinatário. Não é necessário login para acessá-lo. O shortCode identifica exclusivamente o arquivo e está incorporado no URL de download.

Gerenciando Arquivos

Atualmente, o gerenciamento de arquivos está disponível através do painel FlingDrop. A API concentra-se no upload de arquivos e geração de links compartilháveis. Para revogar acesso a um arquivo ou visualizar o histórico de uploads, faça login no seu painel.

Em breve: Endpoints de listagem e exclusão de arquivos podem ser adicionados em uma versão futura. Inscreva-se no nosso blog de desenvolvedores para atualizações.

Padrões Comuns de Integração

1. CRM: Envio automático de proposta em PDF após criação do negócio

Quando um novo negócio é criado no seu CRM, acione um webhook que faz o upload do modelo de proposta e envia ao cliente um link de download por e-mail — sem necessidade de anexar arquivos manualmente.

import requests

def enviar_proposta(email_cliente, caminho_pdf):
    with open(caminho_pdf, 'rb') as f:
        response = requests.post(
            'https://app.flingdrop.com/api/upload',
            headers={'X-API-Key': 'sua_api_key_aqui'},
            files={'file': f}
        )
    data = response.json()
    if data['success']:
        download_url = data['data']['url']
        # envie download_url para email_cliente via seu serviço de e-mail
        return download_url
    else:
        print(f"Upload falhou: {data['error']['message']}")
        return None

2. E-commerce: Entrega de produtos digitais após a compra

Após um webhook de pagamento bem-sucedido no Stripe, faça o upload do arquivo digital comprado e retorne imediatamente uma URL de download ao cliente — sem armazenar arquivos na sua própria infraestrutura.

3. Ferramentas internas: Distribuição de relatórios noturnos

Agende um cron job que faça o upload de relatórios gerados todas as noites e envie links de download por e-mail para as partes interessadas. Os links expiram após 7 dias, mantendo seu armazenamento limpo automaticamente.

#!/bin/bash
ARQUIVO_RELATORIO="/var/relatorios/diario-$(date +%Y%m%d).pdf"
RESPOSTA=$(curl -s -X POST https://app.flingdrop.com/api/upload \
  -H "X-API-Key: $FLINGDROP_API_KEY" \
  -F "file=@$ARQUIVO_RELATORIO")
DOWNLOAD_URL=$(echo $RESPOSTA | jq -r '.data.url')
# envie $DOWNLOAD_URL para o seu sistema de notificação

Referência de Limites do Plano

Limites de Taxa

As requisições à API estão sujeitas aos limites de taxa do plano. Exceder os limites retorna uma resposta 429 Too Many Requests com um cabeçalho Retry-After indicando quando o limite é redefinido.

Primeiros Passos

1. Crie uma conta no FlingDrop em flingdrop.com (cadastro gratuito).
2. Faça upgrade para o plano Business no seu painel para acesso à API.
3. Copie sua API Key do painel.
4. Faça sua primeira requisição de upload usando os exemplos acima.

Guias relacionados:

• 10 Casos de Uso para Compartilhamento Automatizado de Arquivos via API em Fluxos de Trabalho Empresariais
• Como Compartilhar Arquivos pela Linha de Comando — Guia CLI para Desenvolvedores
• O Guia Completo de Links de Download Temporários para Empresas SaaS
• Como Definir Datas de Expiração de Arquivos para Entrega Segura de Documentos