> ## 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.

# Glossário

> Termos da API e da plataforma Shappire

| 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`)           |