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

# Rotas da API pública

> Todas as rotas /v1 disponíveis com chave shp_live_

Todas as rotas abaixo usam o prefixo `https://api.shappire.tools/v1` (ou `http://localhost:8080/v1` em desenvolvimento).

## Health

| Método | Rota      | Auth | Descrição     |
| ------ | --------- | ---- | ------------- |
| `GET`  | `/health` | Não  | Status da API |

## Plataformas

| Método | Rota         | Escopo       | Descrição                    |
| ------ | ------------ | ------------ | ---------------------------- |
| `GET`  | `/platforms` | Chave válida | Lista plataformas suportadas |

## Mídia

| Método | Rota              | Escopo           | Descrição                    |
| ------ | ----------------- | ---------------- | ---------------------------- |
| `POST` | `/media/resolve`  | `media:resolve`  | Resolve metadados e formatos |
| `POST` | `/media/download` | `media:download` | Enfileira job de download    |
| `GET`  | `/jobs/{jobId}`   | Chave válida     | Consulta status do job       |

## Autenticação

Envie `X-API-Key: shp_live_...` ou `Authorization: Bearer shp_live_...`.

Rotas com escopo exigem a permissão na chave — veja [Permissões da API key](/pages/guides/api-permissions).

## Playground interativo

Cada endpoint na sidebar **API Reference → Endpoints** inclui exemplos em Bash, JavaScript e Python com playground.