Instructions
...
Artigos relacionados
| Filter by label (Content by label) | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
| hidden | true |
|---|
...
Passo 1 - Adicione o script e folha de estilo abaixo na tag 'head' do seu portal.
| Code Block | ||
|---|---|---|
| ||
<script type="text/javascript" src="https://cdn.privacytools.com.br/sdkconsent/dist/sdkconsent.min.js"></script>
<link rel="stylesheet" href="https://cdn.privacytools.com.br/sdkconsent/dist/sdkconsent.css" type="text/css" /> |
Passo 2 - Na inicialização do seu código configure o SDK.
| Code Block | ||
|---|---|---|
| ||
<script type="text/javascript">
var sdk = sdkConsent("$base","$publicKey");
</script> |
Registrando um consentimento
Para registrar um consentimento você precisa gerar um identificador único do seu usuário conforme orientação da variável hashUser. Envie também o parâmetro 'consent' (booleano) com o aceite (true) ou rejeição(false) do usuário.
O retorno caso bem sucedido será um text/plain com o protocolo de registro. Como o registro é assíncrono e entra em uma fila de consumidor/processador pode levar entre 30 segundos a 70 segundos para o consentimento poder ser consultado.
Se o ocorrer um erro a mensagem será exibida em um application/json.
Array de consentimentos: Caso você precise enviar um array com vários consentimentos ao mesmo tempo, basta enviar um objeto do tipo Array nos parâmetros $hashTemplate e $consent - Garanta que ambos possuem a mesma quantidade de dados ou serão rejeitados.
| Code Block | ||
|---|---|---|
| ||
sdk.registerConsentForUser($hashTemplate,$hashUser,$consent,function(response){
console.log('success = '+response);
},function(response){
console.log('error = '+JSON.stringify(response));
}); |
Enviando Dados Pessoais Junto com o Consentimento
| Status | ||||
|---|---|---|---|---|
|
Para enviar um conjunto de dados pessoais junto com o consentimento, você precisa criar um JSON no formato abaixo.
| Code Block |
|---|
[
{ "name":"Nome do dado", "value":"Valor do dado"},
...
]
//Exemplo: Enviando nome, cpf e cidade
[
{ "name":"name", "value":"Francisco da silva"},
{ "name":"document", "value":"00000000"},
{ "name":"city", "value":"São Paulo"}
]
|
Uma vez criado o seu objeto JSON, envie como um parâmetro adicional na mesma chamada anterior:
Observe na chamada abaixo a variável “personalData”
| Code Block | ||
|---|---|---|
| ||
sdk.registerConsentForUser($hashTemplate,$hashUser,$consent,function(response){
console.log('success = '+response);
},function(response){
console.log('error = '+JSON.stringify(response));
}, personalData); |
Pronto, com essa configuração o consentimento vai ser registrado e os dados pessoais relacionados ao titular também.
Obtendo todos os consentimentos de um usuário
| Code Block | ||
|---|---|---|
| ||
sdk.getConsentsUser($hashUser,function(response){
if(response && response.length>0){
for(var i=0;i<response.length;i++){
console.log(response[i].hashTemplate+'='+response[i].consent);
}
}else{
console.log('no data')
}
},function(response){
console.log('error = '+JSON.stringify(response));
}); |
Verificando um consentimento específico
| Code Block | ||
|---|---|---|
| ||
sdk.verifyConsentUser($hashTemplate,$hashUser,function(response){
if(response && response.length>0){
for(var i=0;i<response.length;i++){
console.log(response[i].hashTemplate+'='+response[i].consent);
}
}else{
console.log('no data')
}
},function(response){
console.log('error = '+JSON.stringify(response));
}); |
Outras funções disponíveis
Função no SDK | Finalidade |
|---|---|
loadConsentCondition($hashTemplate) | Essa função retorna a estrutura JSON para você criar uma popup/dialog para coletar um determinado consentimento do seu usuário. Ela busca todas as informações registradas na plataforma para o hashTemplate informado. |
askForConsent($hashTemplate,$hashUser) | Essa função é semelhante à anterior mas aqui a popup/dialog é gerada pela API e ela cuida de toda a coleta do consentimento. |