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

# Início rápido

> Primeira integração com a Shappire Media API.

<Note>
  Substitua `shp_live_sua_chave` por uma chave criada no [Developer Dashboard](https://shappire.tools/developer/projects).
</Note>

## 1. Listar plataformas

```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
curl https://api.shappire.tools/v1/platforms \
  -H "X-API-Key: shp_live_sua_chave"
```

## 2. Resolver mídia

```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
curl https://api.shappire.tools/v1/media/resolve \
  -H "X-API-Key: shp_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
```

## 3. Enfileirar download

```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
curl https://api.shappire.tools/v1/media/download \
  -H "X-API-Key: shp_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"media_id":"med_xxx","format":"video_best"}'
```

Resposta: `202 Accepted` com `job_id`.

## 4. Consultar job

```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
curl https://api.shappire.tools/v1/jobs/job_xxx \
  -H "X-API-Key: shp_live_sua_chave"
```

Estados: `queued`, `processing`, `completed`, `failed`, `expired`.