Poradnik Integracji API

Dowiedz się, jak w kilku krokach zaimplementować pobieranie i zapisywanie zgód w swoim systemie.

Zacznij od podstaw

Aby zobaczyć przykłady integracji z Twoimi danymi, musisz najpierw utworzyć przynajmniej jedną zgodę i jeden scenariusz.

Dodaj swoją pierwszą zgodę Skonfiguruj scenariusz
1

Pobieranie treści zgód

Najpierw musisz pobrać aktualne treści zgód dla konkretnego scenariusza (np. rejestracji).

Zapytanie (JavaScript)

const scenarioId = 'ID_TWOJEGO_SCENARIUSZA';
const url = `http://localhost:8081/v1/api/scenarios/${scenarioId}/consents?lang=pl`;

fetch(url)
  .then(res => res.json())
  .then(data => console.log(data));

Przykładowa odpowiedź JSON

{
  "scenario_id": "...",
  "consents": [...]
}
2

Budowa formularza

Wyświetl pobrane zgody w swoim formularzu rejestracyjnym.

Przykładowy Formularz

3

Przesyłanie decyzji (Audit Log)

Po wysłaniu formularza, prześlij decyzje użytkownika do API ConsentHub, aby zachować ścieżkę audytową.

Wysyłka (JavaScript POST)

const payload = {
  identity_string: "jan@kowalski.pl", 
  consents: [
    { id: "uuid-wersji-zgody-1", granted: true },
    { id: "uuid-wersji-zgody-2", granted: false }
  ]
};

fetch(`http://localhost:8081/v1/api/scenarios/ID/consents`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(payload)
});

Oczekiwana odpowiedź

{
  "status": "success",
  "recorded_ids": [
    "uuid-wpisu-w-logu-1",
    "uuid-wpisu-w-logu-2"
  ]
}
Gotowe!

Teraz każda zmiana w panelu zostanie automatycznie uwzględniona w Twoim formularzu.