Cadastro

Fluxo de Cadastro de faces no Container

Para realizar um cadastro de face no Container, o cliente enviará uma rota POST para o endpoint /api/v1/cadastro em formato JSON, contendo: face para cadastro em base64, ID do cliente (acessível no portal), ID do usuário que será cadastrado, Parâmetro Liveness ativado ("ativarLiveness": true) ou Parâmetro Liveness desativado ("ativarLiveness": false) e o token. Os dados serão enviados para o endpoint da API Facesign em formato JSON:

{
"face":"/9j/4DAWLFK...",
"clientid":"658cc36e-XXXX-XXXX-XXXX-29711f9566aa",
"id":"cli0001",
"ativarLiveness":true/false,
"token":"0002221"
}

Este JSON será enviado para a API Facesign, onde será realizada a consulta do ID e se ele já existe no sistema.

• Em caso de ID já cadastrado, haverá o retorno:

{
"clientid":"658cc36e-XXXX-XXXX-XXXX-29711f9566aa",
"id":"cli0001",
"status":"usuário já cadastrado"
}

• Em caso de ID não cadastrado, a face do usuário passará pelo processo de Liveness e cadastro.

Cadastro com Parâmetro Liveness desativado

Com o Parâmetro Liveness desativado, haverá o retorno (positivo ou negativo) do cadastro da face independente do resultado do Liveness, podendo ter os seguintes retornos:

• Face já cadastrada no Container

Code 400 - Erro

{
    "type":"Error",
    "content":{
        "ClientId":"9eec5efd-XXXX-XXXX-XXXX-1f689615d3be",
        "Id":"id001",
        "Status":"Face já existe com outro Id",
        "Liveness":true/false,
        "TransactionId":"9992ac53-XXXX-XXXX-XXXX-e1ac621521d7"
    }
}

• Cadastro concluído

Code 200 - Sucesso

{
    "type":"Success",
    "content":{
        "ClientId":"9eec5efd-XXXX-XXXX-XXXX-1f689615d3be",
        "Id":"id010",
        "Status":"Usuário cadastrado com sucesso",
        "Liveness":true/false,
        "TransactionId":"f02c924a-XXXX-XXXX-XXXX-ed2ba3c35821",
 "Face": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQF..."
    }
}

Cadastro com Parâmetro Liveness ativado

Com o Parâmetro Liveness ativado, a face será cadastrada no Container com o retorno positivo do Liveness, podendo ter os seguintes retornos:

• Liveness true e face já cadastrada

Code 400 - Erro

{
    "type":"Error",
    "content":{
        "ClientId":"9eec5efd-XXXX-XXXX-XXXX-1f689615d3be",
        "Id":"id001",
        "Status":"Face já existe com outro Id",
        "Liveness":true,
        "TransactionId":"9992ac53-XXXX-XXXX-XXXX-e1ac621521d7"
    }
}

• Liveness true e cadastro concluído

Code 200 - Sucesso

{
    "type":"Success",
    "content":{
        "ClientId":"9eec5efd-XXXX-XXXX-XXXX-1f689615d3be",
        "Id":"id010",
        "Status":"Usuário cadastrado com sucesso",
        "Liveness":true,
        "TransactionId":"f02c924a-XXXX-XXXX-XXXX-ed2ba3c35821",
 "Face":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQF..."
    }
}

• Liveness false

Code 400 - Erro

{
    "type":"Error",
    "content":{
        "ClientId":"9eec5efd-XXXX-XXXX-XXXX-1f689615d3be",
        "Id":"id010",
        "Status":"Cadastro não efetuado",
        "Liveness":false,
        "TransactionId":"0fcb3937-XXXX-XXXX-XXXX-488edf3b3b08"
    }
}