> For the complete documentation index, see [llms.txt](https://digitalsac.gitbook.io/digicalls/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digitalsac.gitbook.io/digicalls/api-rest/provisionamento-api-key.md).

# Provisionamento (API key)

API para integradores (Izing Pro, ERP, scripts) gerenciarem **devices WhatsApp QR** do tenant.

Autenticação: header **`X-Api-Key: dgu_…`**

A API key é **por usuário** — devices criados pertencem a esse usuário.

### Criar device

```http
POST /api/devices
Content-Type: application/json
X-Api-Key: dgu_SUA_CHAVE

{ "name": "Atendimento 1" }
```

Resposta:

```json
{
  "device": {
    "id": "uuid",
    "token": "dev_...",
    "name": "Atendimento 1",
    "state": "connecting",
    "paired": false
  }
}
```

Guarde o **`token`** 

### Listar

```http
GET /api/devices
X-Api-Key: dgu_...
```

### QR / status

```http
GET /api/devices/{token}/qr
GET /api/devices/{token}/status
```

### Validar token

```http
POST /api/devices/verify
{ "token": "dev_..." }
```

### Reiniciar pareamento

```http
POST /api/devices/{token}/restart
```

### Histórico

```http
GET /api/devices/{token}/calls
```

### Excluir

```http
DELETE /api/devices/{token}
```

### Gravação

```http
GET /api/recordings/{callId}
```

### Fluxo típico Izing

1. Admin gera API key no DigiCalls
2. Izing guarda key em Settings
3. Ao criar conexão WhatsApp, Izing `POST /api/devices`
4. Exibe QR via `GET .../qr`
5. Frontend usa `dev_...` no `@digitalsac/digicalls-sdk`

Referência completa: `docs/izing/INTEGRACAO-WEBPHONE.md`.

### Limites

`403` se `maxDevices` do usuário foi atingido (conta só devices QR).

### Passkey / import

Endpoints avançados (passkey, session-import) disponíveis para migração — consulte OpenAPI.