# Mobile - Vincular dispositivo via paircode

`POST /device/pair/code`

Pasta: **Dispositivos (Mobile)**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Mobile - Vincular dispositivo via paircode

Confirma o código de 8 caracteres depois que o companion inicia o link (`companion_hello`).

Fluxo: companion chama PairPhone → evento `companion_hello` no mobile → `POST /device/pair/code` → evento `device_paired`.

## Endpoint

```http
POST {{baseUrl}}/device/pair/code
```

## Autenticação

```http
token: {{token}}
```

## Corpo

```json
{
  "code": "ABCD-EFGH"
}
```

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/device/pair/code" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"code": "ABCD-EFGH"}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "pending": true
}
```

## Observações

- Sem `companion_hello` pendente, a API retorna erro.
- Mobile only.

## Corpo (exemplo)

```json
{
  "code": "ABCD-EFGH"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/device/pair/code" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "ABCD-EFGH"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=dispositivos-mobile/mobile-vincular-dispositivo-via-paircode)