> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shappire.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Perguntas frequentes

> Respostas sobre API key, plataformas, jobs e exemplos de código

## Existe ambiente sandbox?

Em produção, chaves usam o prefixo `shp_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 exponha `shp_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 em `result.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 em `GET /platforms` — centenas de hosts do ecossistema [yt-dlp](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md), **exceto YouTube** (bloqueio de IP de servidor). Veja [Plataformas](/pages/guides/plataformas).

## Como aumentar limites?

Entre em contato via [shappire.tools](https://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](/pages/guides/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?

Consulte `error.code` na resposta. Erros como `media_unavailable` não devem ser retentados. Veja [Tratamento de erros](/pages/guides/tratamento-erros-pratica).