calcom-api

Umiejętność integracji z API Cal.com v2 do automatyzacji planowania i zarządzania rezerwacjami. Twoje agenty mogą tworzyć i zarządzać rezerwacjami, sprawdzać dostępność, konfigurować typy spotkań oraz synchronizować kalendarze z infrastrukturą Cal.com. Idealna dla deweloperów budujących systemy integracyjne wymagające pełnej kontroli nad procesem rezerwacji i dostępnością.

1. Przygotuj klucz API Cal.com — zaloguj się na konto Cal.com, przejdź do Settings > Developer > API Keys i wygeneruj nowy klucz (będzie prefixowany cal_live_ lub cal_test_). Skopiuj go — będzie potrzebny w następnym kroku.

2. Skonfiguruj zmienne środowiskowe — ustaw CAL_API_KEY na wartość wygenerowanego klucza. Jeśli budujesz integrację platformową zarządzającą użytkownikami w imieniu innych, dodaj także CAL_CLIENT_ID i CAL_SECRET_KEY (opcjonalnie CAL_WEBHOOK_SECRET do weryfikacji webhooków).

3. Połącz się z API — wszystkie żądania kieruj na https://api.cal.com/v2 z nagłówkiem Authorization: Bearer <twój_klucz_api>. Dla integracji platformowych dodaj nagłówki x-cal-client-id i x-cal-secret-key.

4. Wykonaj pierwszą operację — użyj umiejętności do utworzenia rezerwacji, sprawdzenia dostępności lub pobrania konfiguracji typów spotkań. API obsługuje zarządzanie rezerwacjami, zdarzeniami, dostępnością i synchronizacją kalendarzy.

5. Obsługuj webhooks (opcjonalnie) — jeśli chcesz otrzymywać powiadomienia o zmianach rezerwacji, skonfiguruj webhooks w Cal.com i użyj CAL_WEBHOOK_SECRET do weryfikacji autentyczności przychodzących żądań poprzez nagłówek X-Cal-Signature-256.