Recuperação da imagem aprovada no Liveness

É possível recuperar a imagem nos nossos servidores através do campo SessionId que os nossos sdks respondem como resposta. Para isso, é preciso autenticar na nossa api, recuperar o token de autenticação e com ele fazer uma chamada para recuperar a imagem propriamente dita. Abaixo, um passo a passo de como realizar esse processo:

Exemplo

Primeiramente, faça a chamada de autenticação passando os seguintes parâmetros:

  • clientId - identifica o cliente junto à ClearSale. É o mesmo valor fornecido pela ClearSale para a utilização dos SDKs.
  • clientSecret - chave de autenticação da ClearSale. É o mesmo valor fornecido pela ClearSale para a utilização dos SDKs.

Requisição no ambiente de produção

POST https://liveness.clearsale.com.br/api/auth HTTP/1.1
Content-Type: application/json
{
    "clientId": "*******",
    "clientSecret": "*******"
}

Requisição no ambiente de Homologação

POST https://liveness-hml.clearsale.com.br/api/auth HTTP/1.1
Content-Type: application/json
{
    "clientId": "*******",
    "clientSecret": "*******"
}

Resposta de sucesso

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
    "accessToken":"*******",
    "expiresIn": 300,
    "tokenType": "Bearer",
}

Resposta de erro 401

HTTP/1.1 401 OK
Content-Type: application/json; charset=utf-8
{
    "title": "Invalid client credentials",
    "status": 401,
    "instance": "/api/auth"
}

Resposta de erro 500

HTTP/1.1 500 InternalServerError

Em caso de sucesso, você receberá o accessToken que é necessário para fazer a chamada para recuperação da imagem. Para isso, você deve fazer a seguinte, chamada substituindo o parâmetro SESSIONID, pelo valor do SessionId que foi retornado pelo SDK. Para saber como recuperar o SessionID:

no SDK iOS, clique aqui.
no SDK Android, clique aqui.
no SDK Flutter, clique aqui.
no SDK JavaScript, clique aqui.

Requisição no ambiente de produção

POST <https://liveness.clearsale.com.br/api/image/SESSIONID> HTTP/1.1  
Content-Type: application/json  
Authentication: Bearer accessToken

Requisição no ambiente de homologação

POST <https://liveness-hml.clearsale.com.br/api/image/SESSIONID> HTTP/1.1  
Content-Type: application/json  
Authentication: Bearer accessToken

Resposta de sucesso

HTTP/1.1 200 OK  
Content-Type: application/json; charset=utf-8  
Binario da imagem

Resposta de erro 401

HTTP/1.1 401 OK  
Content-Type: application/json; charset=utf-8  
{  
    "title": "Invalid client credentials",  
    "status": 401,  
    "instance": "/api/auth"  
}

Resposta de erro 500

HTTP/1.1 500 InternalServerError