Autenticação

Token de API

Utilize tokens de API para operações de gestão a partir do seu backend.

Criar um token: Painel → Conta → Chaves de API → Criar Chave

Utilizar nos pedidos:

Authorization: Bearer cf_api_live_abc123...

Exemplos de pedidos

cURL

curl https://api.consentforge.com/api/v1/properties \
  -H "Authorization: Bearer cf_api_live_YOUR_TOKEN"

JavaScript

const res = await fetch('https://api.consentforge.com/api/v1/properties', {
  headers: {
    'Authorization': `Bearer ${process.env.CONSENTFORGE_API_KEY}`,
    'Content-Type': 'application/json',
  }
});
const data = await res.json();

PHP

$response = Http::withToken(env('CONSENTFORGE_API_KEY'))
    ->get('https://api.consentforge.com/api/v1/properties');

Token de Incorporação

O token de incorporação é o identificador público da sua propriedade. É utilizado na tag <script> e é seguro para exposição pública — apenas permite operações de runtime apenas de leitura.

<script
  src="https://cdn.consentforge.com/consentforge.min.js"
  data-token="cf_live_PUBLIC_TOKEN"
></script>

Âmbitos do token

Ao criar uma chave de API, seleccione os âmbitos mínimos necessários:

Âmbito	Acesso
properties:read	Listar e ver propriedades
properties:write	Criar e actualizar propriedades
policies:read	Ver políticas
policies:write	Criar, publicar, reverter políticas
receipts:read	Ver recibos de consentimento
receipts:export	Exportar recibos
webhooks:read	Ver configuração de webhooks
webhooks:write	Criar e actualizar webhooks
users:read	Listar utilizadores
users:write	Convidar e gerir utilizadores
admin	Acesso total (utilize com parcimónia)