# Ativação de dispositivo

A API RESTfull abaixo é indicada para receber dados de ativação de um novo ponto de acesso ao app Cindie.

### Endpoint

\[URL\]/produto/{idpc}/cindie

<p class="callout info">As informações para início dos destes em ambiente ***staging*** (URL e idpc) serão fornecidas ao responsável pela integração.</p>

### Authorization

<table border="1" id="bkmrk-field-type-required-" style="border-collapse: collapse; width: 100%; height: 145px;"><tbody><tr style="height: 29px;"><td style="width: 25.0617%; height: 29px;">**FIELD**</td><td style="width: 11.7284%; height: 29px;">**TYPE**</td><td style="width: 11.1111%; height: 29px;">**REQUIRED**</td><td style="width: 51.9753%; height: 29px;">**DESCRIPTION**</td></tr><tr style="height: 29px;"><td style="width: 25.0617%; height: 29px;">Authorization</td><td style="width: 11.7284%; height: 29px;">String</td><td style="width: 11.1111%; height: 29px;">YES</td><td style="width: 51.9753%; height: 29px;">Bearer Token</td></tr></tbody></table>

<p class="callout info">O Bearer Token será fornecido ao responsável pela integração.</p>

### POST

#### Request data

<table border="1" id="bkmrk-field-type-required--0" style="border-collapse: collapse; width: 100%; height: 174px;"><tbody><tr style="height: 29px;"><td style="width: 20%; height: 29px;">**FIELD**</td><td style="width: 9.38271%; height: 29px;">**TYPE**</td><td style="width: 8.88894%; height: 29px;">**REQUIRED**</td><td style="width: 41.7283%; height: 29px;">**DESCRIPTION**</td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">tvid</td><td style="width: 9.38271%; height: 29px;">string</td><td style="width: 8.88894%; height: 29px;">YES</td><td style="width: 41.7283%; height: 29px;">Identificação única do ponto de acesso</td></tr></tbody></table>

#### Response data

- HTTP 201 CREATED
- HTTP 400 BAD REQUEST

<table border="1" id="bkmrk-field-type-descripti" style="border-collapse: collapse; width: 100%; height: 116px;"><tbody><tr style="height: 29px;"><td style="width: 20%; height: 29px;">**KEY**</td><td style="width: 9.38271%; height: 29px;">**TYPE**</td><td style="width: 41.7283%; height: 29px;">**DESCRIÇÃO**</td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">success</td><td style="width: 9.38271%; height: 29px;">boolean</td><td style="width: 41.7283%; height: 29px;">`True`: usuário criado

`False`: erro na criação do usuário

</td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">data</td><td style="width: 9.38271%; height: 29px;">string</td><td style="width: 41.7283%; height: 29px;">URL com token do usuário</td></tr><tr style="height: 29px;"><td style="width: 20%; height: 29px;">errors</td><td style="width: 9.38271%; height: 29px;">array</td><td style="width: 41.7283%; height: 29px;">JSON OBJECT - ERRORS</td></tr></tbody></table>


<table border="1" id="bkmrk-%C2%A0json-object%C2%A0-field-" style="height: 145px; width: 100%; border-collapse: collapse;"><tbody><tr style="height: 29px;"><td class="align-center" colspan="3" style="width: 71.111%; height: 29px;"><span style="background-color: #3366ff; color: #ffffff;"> **JSON OBJECT - ERRORS** </span></td></tr><tr style="height: 29px;"><td style="width: 10.2469%; height: 29px;">**FIELD**</td><td style="width: 4.5679%; height: 29px;">**TYPE**</td><td style="width: 56.2962%; height: 29px;">**DESCRIPTION**</td></tr><tr style="height: 29px;"><td style="width: 10.2469%; height: 29px;"><span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400;">code</span></td><td style="width: 4.5679%; height: 29px;">String</td><td style="width: 56.2962%; height: 29px;">Código de erro gerado pelo sistema</td></tr><tr style="height: 29px;"><td style="width: 10.2469%; height: 29px;">message</td><td style="width: 4.5679%; height: 29px;">String</td><td style="width: 56.2962%; height: 29px;">Mensagem com a descrição do erro</td></tr></tbody></table>

### Examples

#### Request

```JSON
{
  "tvid": "EgZjaHJvbWUyBggAEEUYOTIMCAEQABgUGIcCGIAEMgoI"
}
```

<p class="callout info">A chave `tvid` deve ter como valor o dado que identifica o dispositivo que está acessando. Por exemplo, o número de série do fabricante, o MAC address ou a identificação do dispositivo no domínio. Alternativamente, pode ser utilizada a identificação física de onde o dispositivo está instalado (leito12, quarto402 etc.). Contudo, em caso de mudança de localização, é recomendada a reconfiguração do `tvid` desse dispositivo movimentado.</p>

#### Response

HTTP 201 OK

```JSON
{
    "success": true,
    "data": "https://cindie.com/#!/user-token/MTAwMi1jbnk4zckAxNzYwMTE0NDExLjA1MTM0MkNpbmRpRQ",
    "errors": null
}
```

#### Response

HTTP 400 BAD REQUEST

```JSON
{
    "success": false,
    "data": null,
    "errors": {
        "code": null,
        "message": "Parâmetros inválidos!"
    }
}
```

<p class="callout warning">O tempo de execução da API na primeira ativação do ponto de acesso pode superar 5 segundos. Recomendamos que o tempo de espera pela resposta tenha tolerância mínima de 10 segundos. Após a primeira ativação, o tempo de resposta será inferior a 1 segundo.</p>

<p class="callout warning">Recomendamos que o processo de ativação para SmartTV e TV Box seja feito por implantação massiva prévia. Favor consultar o Analista de Integração responsável pelo seu projeto para informações a respeito desse processo.</p>