Objeto Device

O registro de um dispositivo com identificação única deve ser realizada através do endpoint de Device. Para que o cadastro seja efetivado é necessário a utilização da Device scan para que a identificação desse dispositivo, seja salva e identificada posteriormente.

Dinâmica dos Status - status

O status status relacionado ao status do dispositivo. Os seguintes status estão disponíveis:

• registered
• not_registered
• deactivated

Dinâmica dos Status - analysis_status

O status analysis_status indica o status da decisão do motor de fraude e possui uma máquina de estados bastante simples:

• automatically_approved
• automatically_reproved
• in_manual_analysis
• manually_approved
• manually_reproved
• pending

Definição do Objeto Device

Request Body

{
  "device_id": "12345678",
  "session_id": "12345678",
  "face_recognition_key": "12345678"
}

Todas as trocas de informação de um cadastro utilizam a seguinte definição para este objeto. Em alguns casos, para facilitar a implementação e diminuir o fluxo de dados entre as partes, algumas informações poderão ser omitidas.

nome	tipo	descrição
device_id	string	Identificador do dispositivo. É essencial que este número seja único para cada dispositivo (obrigatório)
session_id	string	Identificador da sessão na Device Scan.(obrigatório)
face_recognition_key	string	Identificador da imagem para biometria facial caso o produto seja contratado.

Enviar um Device Registration

Request Body

  {
    "device_id": "12345",
    ...
  }

Response Body

  {
    "device_id": "12345",
    "status": "registered",
    "analysis_status": "automatically_approved",
    "reason": "rule_decision_enum"
  }

Para realizar o registro de um Dispositivo, basta enviar um objeto do tipo Device ao seguinte endpoint:

POST https://api.caas.qitech.app/device_manager/account/{account_id}/person/{person_id}/device