| Termo | Definição |
|---|---|
| API key | Secret shp_live_... para autenticação server-to-server |
| Projeto | Container de chaves, uso e jobs no Developer Dashboard |
| Resolve | Operação síncrona que extrai metadados de uma URL |
| media_id | Campo do download — valor de data.id retornado pelo resolve (med_...) |
| Job | Tarefa assíncrona de download (job_...) |
| Format | Identificador de saída (video_best, audio_best, …) |
| Plataforma | Host de origem (tiktok, instagram, soundcloud, …) |
| Escopo | Permissão da chave (media:resolve, media:download) |
| Envelope | Formato { data } ou { error } das respostas JSON |
| request_id | ID de correlação para suporte (req_... / header X-Request-Id) |
| URL assinada | Link temporário em result.download_url após job concluído |
| TTL | Tempo de validade do media_id ou download_url |
| Polling | Consultas repetidas em GET /jobs/{id} até conclusão |
| Worker | Processo backend que executa downloads assíncronos |
| Rate limit | Limite de 60 req/min por API key |
| Concorrência | Máximo de 2 jobs de download simultâneos por projeto |
| Capability | Tipo de mídia suportada (video, audio, image, metadata) |
Glossário
Termos da API e da plataforma Shappire