API statystyk i uczestników

Kierunek outbound odczytu: Twój system (Make, Zapier, BI, własny backend) pobiera dane z Webivio przy użyciu tokenu konta.

To nie jest to samo co API rejestracji (zapis uczestnika tokenem per webinar w query).

Token w ustawieniach

1. Ustawienia → API (tokeny) → Generuj token.
2. Nadaj nazwę (np. „Make produkcja”).
3. Skopiuj token od razu — plaintext jest pokazywany tylko raz.
4. Możesz mieć wiele tokenów; Unieważnij albo Usuń niepotrzebne.

Prefiks tokenu: wvapi_…. W bazie trzymamy wyłącznie hash SHA-256.

Auth

Authorization: Bearer wvapi_YOUR_TOKEN

albo

X-Api-Key: wvapi_YOUR_TOKEN

Endpointy

Base: https://TWOJA-DOMENA/api/public/v1

Lista webinarów

GET /api/public/v1/webinars

Odpowiedź: { data: [{ id, name, title, status }, ...] }

Statystyki (agregaty)

GET /api/public/v1/webinars/{webinarId}/stats?from=2026-09-01&to=2026-09-30

Query from / to (ISO) opcjonalne — domyślnie ostatnie 30 dni.

Pola m.in.: pageVisits, registrations, attendance, offerClicks, purchaseCount, purchaseRevenueSum (+ atrybucja attributed/unknown).

Uczestnicy (pełna lista)

GET /api/public/v1/webinars/{webinarId}/participants?page=1&pageSize=50&from=2026-09-01&to=2026-09-30

• page, pageSize (max 200)
• from / to — filtr daty (dzień kalendarzowy)

Pola uczestnika m.in.: dane kontaktowe, frekwencja, klik oferty, czas oglądania, %, UTM, wariant A/B.

Przykład curl

curl "https://TWOJA-DOMENA/api/public/v1/webinars/WEBINAR_UUID/stats" \
  -H "Authorization: Bearer wvapi_YOUR_TOKEN"

Odpowiedzi błędów

Bezpieczeństwo

• Nie commituj tokenu do repozytorium ani frontu publicznego.
• Unieważnij token po wycieku.
• Allowlista IP — planowana w kolejnej wersji.