Existe ambiente sandbox?
Em produção, chaves usam o prefixoshp_live_. Em desenvolvimento local (NODE_ENV diferente de production), o prefixo é shp_test_. Use um projeto de desenvolvimento com limites baixos e URLs de teste.
Posso usar a API no frontend?
Não exponhashp_live_ no browser. Chame a API apenas do seu backend.
Quanto tempo o media_id vale?
TTL padrão: 1 hora (API_MEDIA_RESOLVE_TTL_SECONDS=3600). O resolve retorna data.id — use como media_id no download. Se media_not_found, faça resolve de novo.
Quanto tempo a download_url vale?
Definido emresult.expires_at na resposta do job concluído. Baixe imediatamente ou armazene o arquivo no seu storage.
Quais plataformas são suportadas?
Lista dinâmica emGET /platforms — centenas de hosts do ecossistema yt-dlp, exceto YouTube (bloqueio de IP de servidor). Veja Plataformas.
Como aumentar limites?
Entre em contato via shappire.tools com volume estimado e caso de uso.Onde está o OpenAPI?
https://api.shappire.tools/openapi.yaml e playground na tab API Reference.
Quais linguagens têm exemplos?
JavaScript, Python, Go, PHP, Ruby, Java e cURL. Veja Exemplos por linguagem.Posso passar URL direto no download?
Sim.POST /media/download aceita url + format sem resolve prévio — mas resolver antes evita reprocessamento.
Quantos downloads simultâneos?
Máximo de 2 jobs ativos por projeto. Use fila para escalar.O que fazer quando o job falha?
Consulteerror.code na resposta. Erros como media_unavailable não devem ser retentados. Veja Tratamento de erros.