Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Para consumo do Endpoint você deve criar um usuário de API na sua plataforma, segue a documentação: Usuários para de API

Info

Você Para importar o consentimento você deve criar a Finalidade dentro da plataforma para gerar o hash do registro que será vinculado ao consentimento:Gerenciando Finalidades

...

O endpoint consent/import é utilizada para inserir um titular de dados na plataforma, junto com seu status de consentimento. é É principalmente utilizado para realizar a integração de um formulário de consentimentos aplicado no seu site com a nossa plataforma.

A API também não possui limite de requisição de forma síncrona, sendo suportado pela nossa arquitetura e escalabilidade.

...

Após essas configurações você pode utilizar a API de integração abaixo: 

Realize um POST para “https://dpo.privacytools.com.br/external_api_v2/consent/import

...

Code Block
{
"consentValue": true,
"document": "12345678913",
"email": "teste@teste.com",
"name": "teste",
"templateHash": "4a06afc697dca38388ed1c7f8838b41536c307b4e630fbc0d46b5b84aff13b"
"userAgent": "teste123" ,
"userIp": "123456789" ,
"groupName": "Teste"
}

...

Dados Obrigatórios:

Code Block
  "consentDate": "string",
  "consentValue": true,
  "name": "string",
  "email":"string",
  "templateHash": "string"

...

Exemplo de composição do Json para atualizar cadastro do titular de dados:

Info

A diferença esta no É necessario utilizar o campo "updateUserData", essa variável informa para API se deve ou não realizar a atualização dos dados.

Valores:

true - para atualizar

false - não atualizar

Code Block
{
"updateUserData": true,
"consentValue": true,
"document": "12345678913",
"email": "teste@teste.com",
"name": "teste",
"templateHash": "4a06afc697dca38388ed1c7f8838b41536c307b4e630fbc50d416bb84aff13b"
"userAgent": "teste123" ,
"userIp": "123456789" ,
"groupName": "Teste"
}

...

Variáveis e Chaves

Variável

Significado

Onde encontrar

$base
URL base do seu ambiente PrivacyTools
Menu 'Consentimentos
/
> Api de integração'.
consentValue
Se deseja enviar consentimento
 
Valor do consentimento deste usuario
Valor fornecido a variar do titular
Valores:
true - Consentimento aceito
false - Consentimento revogado
document
CPF
CPF
Valor fornecido a variar do titular
de dados a ser enviado.
email
E-mail
E-mail
Valor fornecido a variar do titular
de dados a ser enviado.
metadata
Envio de metadados do titular.
É possível
enviar os metadados associados
criar dados adicionais não listados por padrão ao titular de dados.
Valores necessarios:
“name”: Declara o nome do metadado.
“value”: fornece o valor ao metadado.
name
Nome
Nome
do titular
Valor fornecido a variar do titular
de dados a ser enviado.
templateHash
Código hash da finalidade específica
Menu
'Consentimentos/Finalidades',
:“Finalidades” escolha o grupo e depois copie o hash da finalidade.
updateUserData
Se deseja atualizar os dados já cadastrados na plataoforma
Valor
Valores:
true - para atualizar
false - não atualizar
userAgent
O navegador que o titular está utilizando ao interagir com o consentimento.
Valor fornecido a variar do titular
userIp
Informar o IP do user que está coletando o consentimento
Valor fornecido a variar do titular
groupName
Grupo de titulares que o titular esta vinculado
Criado e gerenciado na plataforma, em “preferencias > grupos de titulares”

...

Info

O userIP e userAgent devem ser informado no corpo da requisição pelo usuário da mesma, são parâmetros não obrigatórios.

...