Verificação no Lado do Servidor

Para renderização no lado do servidor, endpoints de API ou qualquer operação de backend que dependa do consentimento, utilize a API do ConsentForge para verificar o estado do consentimento antes de processar dados.

Quando utilizar a verificação no lado do servidor

• Marketing por e-mail: verificar o consentimento antes de adicionar um contacto a uma lista
• Pipelines de análise: verificar o consentimento antes de armazenar dados comportamentais
• Tecnologia publicitária: verificar o consentimento antes de passar dados a um DSP
• Qualquer personalização no lado do servidor que exija consentimento

Endpoint

GET https://api.consentforge.com/api/v1/consent/check
Authorization: Bearer YOUR_API_TOKEN

Parâmetros de consulta

Parâmetro	Tipo	Descrição
property_id	string	O ID da sua propriedade
user_id	string	Identificador de utilizador com hash (ver abaixo)
category	string	Categoria de consentimento a verificar

Resposta

{
  "has_consent": true,
  "category": "analytics",
  "receipt_id": "rec_abc123",
  "recorded_at": "2026-03-09T12:00:00Z",
  "policy_version": 3
}

Identificador de utilizador

O user_id deve ser um hash que preserve a privacidade. Utilize o mesmo método de hash que o runtime do ConsentForge:

// SHA-256 de (ip_address + user_agent + property_id + date)
const userId = sha256(`${ip}|${userAgent}|${propertyId}|${date}`);

Consulte a documentação de Autenticação da API para obter o seu token de API.

Não armazene IPs em bruto

A API do ConsentForge nunca armazena endereços IP em bruto. Aplique sempre o hash antes de consultar.