# QR Code do link

> Baixe o QR Code de um link curto em PNG ou SVG, com cores, legenda e logo no centro.

Fonte: https://curtei.com/docs/api/qr-code

Endpoint: `GET https://api.curtei.com/v1/links/{id}/qr`
Escopo: `links:read`

A resposta de todo link traz `qr_code_url`. O QR aponta para o link curto com `?qr=1`, então as métricas separam quem escaneou de quem clicou.

| Parâmetro | Valores |
| --- | --- |
| `format` | `png` (padrão) ou `svg` |
| `size` | 128 a 2048 pixels |
| `margin` | 0 a 64 |
| `color`, `background` | `#rrggbb`. O código precisa ser mais escuro que o fundo, com contraste de pelo menos 3:1 |
| `error_correction` | `low`, `medium`, `quartile` ou `high` |
| `label` | Texto embaixo do código, até 40 caracteres |

```bash
curl "https://api.curtei.com/v1/links/{id}/qr?format=svg&size=1024&color=%2315171A" \
  -H "Authorization: Bearer $CURTEI_TOKEN" -o qr.svg
```

## Com logo

Use `POST /links/{id}/qr` em multipart com o campo `logo` (PNG ou JPG até 512 KB) e os mesmos parâmetros acima. O logo vai no centro e a correção de erro passa a `high`.

Só precisa do QR, sem conta nem API? Use o [gerador de QR Code grátis](https://curtei.com/gerador-qr-code).