API

O token é gerado através de um usuário e senha que deve ser fornecido pela ClearSale.

Entre em contato com o seu consultor de vendas para maiores informações.

Na autenticação, além do token retornamos o tempo de expiração em segundos. É necessário que contemple no seu desenvolvimento o gerenciamento da vida útil do token com base nessa data de expiração, pois, durante o ciclo de vida do token, será enviado o mesmo token, mesmo se fizerem uma nova requisição ao endpoint. Por exemplo, o ciclo de vida do token é de 7200 segundos, ao criar um novo token, ele valerá durante este tempo. Se após 1800 segundos, você fizer uma nova requisição, o token devolvido será o mesmo de 1800 segundos atrás. Por isso, o uso correto da api de autenticação é fazer uma nova chamada apenas quando o token gerado anteriormente tiver expirado.

Para o recebimento desse dado é necessário que reserve um espaço de 2048 caracteres.

No retorno, existem dois campos, sendo eles “token” e “expiresInSeconds”, onde o campo token é onde é devolvido o Token JWT, e o campo expiresInSeconds devolve quando tempo em segundos falta para expirar o token.

Requisição

POST https://datatrustapi.clearsale.com.br/v1/authentication/
Content-Type: application/json

{
    "Username": "{Your User}",
    "Password": "{Your Password}"
}

POST https://datatrustapihml.clearsale.com.br/v1/authentication/ HTTP/1.1
Content-Type: application/json

{
    "Username": "{Your User}",
    "Password": "{Your Password}"
}

Resposta

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

{
  "token": "{JWT Token}",
  "expiresInSeconds": "{expiração em segundos}"
}    

Websites e Mobile Apps

As integrações de websites através de JavaScript e aplicativos mobile são feitas através de uma chave de 10 caracteres alfanuméricos.

Entre em contato com o seu consultor de vendas para maiores informações.

🔗

JavaScript Snippet: https://pt.wikipedia.org/wiki/UTF-8

🔗

Mobile SDK: https://pt.wikipedia.org/wiki/UTF-8