# QR code como imagem

Fonte: https://apiwpp.com/docs/api/projetos/qr-code-como-imagem
Seção: Projetos
Atualizado em: 2026-09-28

`GET /tenants/{id}/connections/{connId}/qr`

Como [`GET /connections/{id}/qr`](https://apiwpp.com/docs/api/conexoes/qr-code-e-status), com o QR code já renderizado como imagem PNG em data URL (`data:image/png;base64,…`), pronto para usar como fonte de uma imagem. Escopo necessário: `connections:read`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string · uuid` | sim | Identificador do projeto (`tenantId`). |
| `connId` | `string · uuid` | sim | Identificador da conexão (o número) no projeto. |

## Exemplo de requisição

### cURL

```bash
curl https://api.apiwpp.com/tenants/$TENANT_ID/connections/$CONNECTION_ID/qr \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/tenants/${tenantId}/connections/${connectionId}/qr`, {
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->get("https://api.apiwpp.com/tenants/{$tenantId}/connections/{$connectionId}/qr");
```

### Python

```python
import requests

response = requests.get(
    f"https://api.apiwpp.com/tenants/{tenant_id}/connections/{connection_id}/qr",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | O QR code em `qrCode` (enquanto a conexão pareia) e o `status`. |
| 400 | `FST_ERR_VALIDATION` | `id` ou `connId` não é um UUID; `message` diz o que está errado. |
| 401 |  | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde `401`. |
| 402 | `subscription_inactive` | A organização dona do projeto não pode usar o WhatsApp agora: o período de teste acabou, ou uma fatura venceu e passou do prazo de carência. O corpo traz `error` e `code`; regularize a assinatura no painel. |
| 403 |  | A chave não tem o escopo `connections:read`; a mensagem de erro cita o escopo que falta. |
| 404 |  | O projeto ou a conexão não existe, ou não é de quem chama (`Tenant not found`, `Connection not found`). A conexão precisa ser do projeto do caminho. |
| 429 |  | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de `Retry-After`. Veja [Limites](https://apiwpp.com/docs/referencia/limites). Cabeçalhos: `Retry-After`. |
| 503 |  | A instância do gateway que roda a conexão está mudando (um reinício, um failover) ou não responde: espere os segundos de `Retry-After` e tente de novo. Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "qrCode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "status": "connecting"
}
```

## Detalhes

O QR code só vem para quem tem o escopo `connections:write`, porque escaneá-lo conecta um número à conexão. Só com `connections:read`, `qrCode` vem `null` e o `status` continua disponível. `qrCode` também é `null` quando não há QR code para escanear.

`status` é o atual, da instância do gateway que roda a conexão, ou, sem ele, o gravado; sempre em minúsculas. `passkey_required`: o QR code foi escaneado, mas o celular pediu uma passkey e o pareamento parou; veja [Parear um número](https://apiwpp.com/docs/guias/parear-um-numero).

Guia: [Parear um número](https://apiwpp.com/docs/guias/parear-um-numero).
