Como Compartilhar Arquivos pela Linha de Comando — Guia CLI para Desenvolvedores

A interface de linha de comando (CLI) do FlingDrop permite fazer upload de arquivos e recuperar links de download temporários diretamente do terminal — sem abrir um navegador ou usar uma interface gráfica. Está disponível para Windows, macOS e Linux, tornando-a a ferramenta certa para desenvolvedores, sysadmins e engenheiros de DevOps que trabalham no terminal.

Instalação

macOS

# Baixar o binário para macOS
curl -L https://app.flingdrop.com/cli/download/macos -o flingdrop
chmod +x flingdrop
sudo mv flingdrop /usr/local/bin/

Ou instale via Homebrew (se o tap estiver configurado):

brew install flingdrop

Linux

curl -L https://app.flingdrop.com/cli/download/linux -o flingdrop
chmod +x flingdrop
sudo mv flingdrop /usr/local/bin/

Windows

Baixe o flingdrop.exe em flingdrop.com/download ou via PowerShell:

Invoke-WebRequest -Uri "https://app.flingdrop.com/cli/download/windows" -OutFile "flingdrop.exe"

Adicione o diretório contendo flingdrop.exe ao seu PATH para acesso global.

Configuração

Antes do primeiro upload, configure sua API Key:

flingdrop config set api-key SUA_API_KEY_AQUI

Sua API Key está disponível no painel do FlingDrop ou foi enviada por e-mail no momento do cadastro. A chave é armazenada em ~/.config/flingdrop/config.json (Linux/macOS) ou %APPDATA%\flingdrop\config.json (Windows).

Verifique sua configuração:

flingdrop config show

Uso Básico

Fazer upload de um arquivo

flingdrop upload relatorio.pdf

Saída:

Uploading relatorio.pdf... done
Download link: https://app.flingdrop.com/d/f_abc123xyz
Expires: 2026-04-01 (30 days)
Link copied to clipboard.

Upload com expiração personalizada

flingdrop upload contrato.pdf --expires 14

Upload e obter apenas a URL (para scripts)

flingdrop upload exportacao-dados.csv --quiet
# Retorna apenas a URL, sem texto de progresso

Listar seus arquivos enviados

flingdrop list

Excluir um arquivo

flingdrop delete f_abc123xyz

Exemplos de Scripts

Bash: Upload de backup noturno

#!/bin/bash
ARQUIVO_BACKUP="/var/backups/db-$(date +%Y%m%d).sql.gz"
pg_dump mydb | gzip > "$ARQUIVO_BACKUP"

LINK=$(flingdrop upload "$ARQUIVO_BACKUP" --expires 7 --quiet)
echo "Backup enviado: $LINK"

# Envie o link via e-mail, Slack ou notificação do PagerDuty
curl -X POST https://hooks.slack.com/services/SEU/WEBHOOK \
  -H 'Content-type: application/json' \
  -d "{\"text\": \"Backup noturno pronto: $LINK\"}"

Python: Upload a partir de um script

import subprocess

def upload_para_flingdrop(caminho_arquivo, dias_expiracao=7):
    result = subprocess.run(
        ['flingdrop', 'upload', caminho_arquivo, '--expires', str(dias_expiracao), '--quiet'],
        capture_output=True, text=True
    )
    return result.stdout.strip()

download_url = upload_para_flingdrop('/tmp/relatorio.pdf', dias_expiracao=14)
print(f"Relatório disponível em: {download_url}")

CI/CD: Compartilhar artefatos de build

Em um workflow do GitHub Actions, faça upload de artefatos de build e poste o link em um comentário de PR:

- name: Upload build artifact
  run: |
    LINK=$(flingdrop upload dist/app.zip --expires 3 --quiet)
    echo "Build artifact: $LINK" >> $GITHUB_STEP_SUMMARY
  env:
    FLINGDROP_API_KEY: ${{ secrets.FLINGDROP_API_KEY }}

Nota: Defina FLINGDROP_API_KEY como uma variável de ambiente para substituir o arquivo de configuração em ambientes de CI.

Configuração via Variável de Ambiente

Para ambientes de CI/CD e contêinerizados onde gravar em um arquivo de configuração não é prático:

export FLINGDROP_API_KEY=sua_api_key_aqui
flingdrop upload arquivo.zip

A variável de ambiente tem precedência sobre o arquivo de configuração.

Limites do Plano

A CLI respeita os mesmos limites da interface web e da API. Tentar fazer upload de um arquivo maior do que o permitido pelo seu plano retorna um erro com uma mensagem clara.

Resolução de Problemas

command not found: flingdrop: Certifique-se de que o binário está em um diretório listado no seu $PATH. Execute echo $PATH para verificar.

Authentication failed: Execute novamente flingdrop config set api-key SUA_CHAVE. Verifique a chave no seu painel do FlingDrop.

File size exceeds plan limit: Faça upgrade do seu plano no painel do FlingDrop para aumentar o limite por arquivo.

Upload trava em arquivos grandes: O FlingDrop usa uploads multipart para arquivos maiores de 100MB. Se a sua conexão de rede for instável, a CLI tentará automaticamente até 3 vezes antes de falhar.

Resumo

A CLI do FlingDrop fornece uma interface rápida e com suporte a scripts para compartilhamento temporário de arquivos que se integra naturalmente aos fluxos de trabalho de desenvolvimento — desde uso pontual no terminal até pipelines de CI/CD e scripts agendados. Instale uma vez, configure sua API Key e flingdrop upload se torna a maneira mais rápida de compartilhar um arquivo de qualquer sessão de terminal.

Guias relacionados:

• Como Automatizar a Entrega de Arquivos com a API REST do FlingDrop
• 10 Casos de Uso para Compartilhamento Automatizado de Arquivos via API em Fluxos de Trabalho Empresariais
• O Guia Completo de Links de Download Temporários para Empresas SaaS