Dokumentacja
Twórz webinary, dodawaj terminy, przygotowuj transmisje YouTube i pobieraj zapisy uczestników z własnych narzędzi. Ten sam klucz działa w REST API, na serwerze MCP i w skillu dla agentów AI.
Szybki start
- W panelu wejdź w Klucze API i utwórz klucz (dostępne od pakietu Starter).
- Skopiuj klucz — pokazujemy go tylko raz.
- Dodawaj go do każdego zapytania w nagłówku
X-Api-Key.
export WEBINARLY_API_KEY="wbn_live_..."
curl -s "https://webinarly.eu/api/public/v1/webinars" \
-H "X-Api-Key: $WEBINARLY_API_KEY"Adres bazowy: https://webinarly.eu/api/public/v1. Odpowiedzi są w formacie JSON, błędy mają postać { "error": "...", "code": "..." }. Zapytania z przeglądarki są dozwolone (CORS), ale nigdy nie umieszczaj klucza w kodzie strony.
Endpointy
/v1/meDane przestrzeni i aktywny pakiet.
/v1/statsZużycie limitów: minuty transmisji, zapisy, e-maile, serie, zespół.
/v1/webinarsLista serii webinarów. Parametry: limit, status.
/v1/webinarsNowa seria webinarów.
{
"title": "Webinar o AI w sprzedaży",
"description": "Cotygodniowe spotkanie na żywo",
"recurrenceRule": "weekly",
"firstStartAt": "2026-10-06T17:00:00Z",
"defaultDurationMinutes": 60,
"maxOccurrences": 8,
"status": "active"
}/v1/webinars/{id}Szczegóły serii wraz z terminami i adresem strony zapisów.
/v1/webinars/{id}Zmiana tytułu, opisu, statusu lub ustawień terminów.
/v1/webinars/{id}Usunięcie serii.
/v1/webinars/{id}/sessionsTerminy serii. Parametr: upcoming=true.
/v1/webinars/{id}/sessionsDodanie terminu transmisji.
{ "startAt": "2026-10-13T17:00:00Z" }/v1/sessions/{id}Zmiana daty, tytułu lub opisu terminu.
/v1/sessions/{id}Usunięcie terminu.
/v1/sessions/{id}/youtubeUtworzenie transmisji YouTube dla terminu.
/v1/sessions/{id}/startPrzygotowanie transmisji: sprawdzenie limitów, transmisja YouTube i link do studia (studioUrl). Obraz i dźwięk idą z okna studia w przeglądarce.
/v1/sessions/{id}/stopZdalne zakończenie transmisji.
/v1/registrationsZapisy uczestników. Parametry: webinar_id, session_id, from, to, limit.
/v1/registrationsZapis uczestnika na termin.
{ "sessionId": "…", "email": "anna@firma.pl", "name": "Anna Kowalska" }Limity i błędy
Operacje zapisu respektują limity pakietu — tak samo jak w panelu. Po wyczerpaniu limitu API zwraca kod 402 i opis, na jaki pakiet przejść.
401 missing_api_key / invalid_api_key / expired_api_key— Brak, nieprawidłowy lub wygasły klucz.403 read_only_key— Klucz ma wyłącznie uprawnienia do odczytu.402 plan_limit_reached— Wyczerpany limit pakietu — przejdź na wyższy plan.404 not_found— Zasób nie należy do tej przestrzeni albo nie istnieje.409 already_registered / already_live— Uczestnik już zapisany albo termin jest już nadawany.
Serwer MCP dla asystentów AI
Podłącz Webinarly do Claude, ChatGPT, Cursor czy innego klienta MCP. Adres serwera to https://webinarly.eu/api/public/mcp, autoryzacja tym samym kluczem API. Narzędzia zmieniające dane (tworzenie serii, terminów, start i stop transmisji) są oznaczone jako wymagające potwierdzenia.
{
"mcpServers": {
"webinarly": {
"type": "http",
"url": "https://webinarly.eu/api/public/mcp",
"headers": { "X-Api-Key": "wbn_live_..." }
}
}
}Dostępne narzędzia: list_webinars, get_webinar, create_webinar, update_webinar, list_sessions, add_session, update_session, create_youtube_broadcast, start_broadcast, stop_broadcast, list_registrations, create_registration, get_stats.
Skill dla agenta — pakiet zgodny z dobrymi praktykami
Nie jeden plik, tylko kompletny pakiet ZIP: krótki SKILL.md z opisem wyzwalającym, referencje doczytywane dopiero wtedy, gdy są potrzebne (progresywne ładowanie kontekstu), gotowe scenariusze pracy oraz wykonywalny skrypt powłoki. Bez instalacji z npm — wystarczy rozpakować.
SKILL.md
Zwięzła instrukcja, zasady bezpieczeństwa i mapa pozostałych plików.
references/
Pełne API, scenariusze, konfiguracja MCP i rozwiązywanie problemów.
scripts/webinarly.sh
Gotowy wrapper na API — agent woła jedną komendę zamiast budować curl.
Klucz tylko w środowisku
Skill nigdy nie zapisuje klucza w treści — czyta go z WEBINARLY_API_KEY.
mkdir -p ~/.agents/skills && cd ~/.agents/skills && \
curl -fsSL https://webinarly.eu/skill.zip -o webinarly-skill.zip && unzip -o webinarly-skill.zipPotrzebujesz czegoś więcej?
Webhooki, wyższe limity zapytań albo dedykowana integracja — napisz do nas.
Skontaktuj się