Casos de uso

​

Bot de Telegram / Discord

1. Usuário envia link no chat
2. Backend resolve metadados e mostra preview (título + thumbnail)
3. Usuário confirma → enfileira download
4. Bot envia arquivo quando status: completed

// Pseudo-fluxo
const media = await resolveMedia(userUrl);
await bot.sendPhoto(chatId, media.thumbnail, { caption: media.title });
const jobId = await enqueueDownload(media.id, 'video_best');
const job = await waitForJob(jobId);
await bot.sendDocument(chatId, job.result.download_url);

​

SaaS de clipping

• Resolve URL do creator
• Lista formatos para o usuário escolher qualidade
• Download assíncrono em worker separado
• Armazena no S3/R2 antes de expires_at

​

Agregador de conteúdo

• Cron diário busca URLs de um feed
• Resolve em batch (respeite rate limit: 60/min)
• Enfileira apenas URLs novas
• Persiste media_id + job_id no banco

​

App mobile (via backend)

Mobile App → seu API Gateway → Shappire API

​

Pipeline de áudio

1. Resolve URL de podcast / SoundCloud / Vimeo
2. Download com format: audio_best
3. Transcreve ou processa o arquivo localmente

​

Monitoramento de jobs

​

Limites a considerar