Uwierzytelnianie

Token API

Używaj tokenów API do operacji zarządzania z Twojego backendu.

Utwórz token: Pulpit → Konto → Klucze API → Utwórz klucz

Użycie w żądaniach:

Authorization: Bearer cf_api_live_abc123...

Przykładowe żądania

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 osadzenia

Token osadzenia to publiczny identyfikator Twojej właściwości. Jest używany w tagu <script> i jest bezpieczny do publicznego ujawnienia — pozwala tylko na operacje środowiska uruchomieniowego tylko do odczytu.

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

Zakresy tokenów

Podczas tworzenia klucza API wybierz minimalne niezbędne zakresy:

Zakres	Dostęp
properties:read	Listowanie i przeglądanie właściwości
properties:write	Tworzenie i aktualizacja właściwości
policies:read	Przeglądanie polityk
policies:write	Tworzenie, publikowanie, cofanie polityk
receipts:read	Przeglądanie paragonów zgody
receipts:export	Eksportowanie paragonów
webhooks:read	Przeglądanie konfiguracji webhooków
webhooks:write	Tworzenie i aktualizacja webhooków
users:read	Listowanie użytkowników
users:write	Zapraszanie i zarządzanie użytkownikami
admin	Pełny dostęp (używaj oszczędnie)