Cal.com OAuth

Dodaj Cal.com do swojej aplikacji

Jeden przycisk łączy konta Cal.com Twoich użytkowników. Twoja aplikacja odczytuje potem ich dostępność i rezerwuje w ich imieniu przez API v2, tylko z zakresami, na które pozwolą. Gotowe? Dodaj ją do Cal.com App Store.

Zaufali nam szybko rosnące firmy z całego świata

Kontynuuj z Cal.com

Oficjalne przyciski serwowane z app.cal.com. Sprawdź każdy na jasnym lub ciemnym tle, skopiuj go jako HTML, React, Markdown albo URL, a potem wstaw swój identyfikator klienta i URI przekierowania.

Background
Copy as
  • Continue with Cal.com, dark, rounded
    Dark, rounded
  • Continue with Cal.com, light, rounded
    Light, rounded
  • Continue with Cal.com, neutral, rounded
    Neutral, rounded
  • Continue with Cal.com, dark, squared
    Dark, squared
  • Continue with Cal.com, light, squared
    Light, squared
  • Continue with Cal.com, neutral, squared
    Neutral, squared
  • Continue with Cal.com, coss ui
    coss ui

Od przycisku do rezerwacji

Standardowy OAuth 2.0 z przepływem kodu autoryzacyjnego. Przycisk wysyła użytkowników do Cal.com, gdzie wybierają, co Twoja aplikacja może zrobić, a Ty wymieniasz kod na tokeny.

  • Klienci poufni trzymają sekret na serwerze; klienci publiczni używają PKCE (S256).
  • Tokeny dostępu są ważne 30 minut; tokeny odświeżania pobierają nowe.
  • Do 10 dokładnych URI przekierowania na klienta, bez symboli wieloznacznych.
  • Token wywołuje tylko endpointy objęte jego zakresami.

Wyślij użytkowników do Cal.com

Link przycisku. Cal.com pokazuje ekran zgody i przekierowuje z powrotem z kodem.

1GET https://app.cal.com/auth/oauth2/authorize2  ?client_id=YOUR_CLIENT_ID3  &redirect_uri=https://your-app.com/callback4  &state=YOUR_STATE5  &scope=BOOKING_READ%20BOOKING_WRITE67# z powrotem po Twojej stronie8https://your-app.com/callback?code=AUTHORIZATION_CODE&state=YOUR_STATE

Trzy kroki do App Store

Klient OAuth łączy Twoją aplikację z kontami użytkowników. Wpis w App Store to sposób, w jaki użytkownicy Cal.com ją znajdują.

01

Utwórz klienta OAuth

W Ustawienia → Deweloper → OAuth, nazwij swoją aplikację, wybierz co najmniej jeden zakres i dodaj URI przekierowania. Klient zaczyna jako oczekujący; Cal.com sprawdzi go i wyśle Ci e-mail, gdy zostanie zaakceptowany.

02

Dodaj przycisk

Umieść przycisk Kontynuuj z Cal.com tam, gdzie Twoi użytkownicy łączą narzędzia. Otwiera on ekran zgody Cal.com, a Twój callback wymienia kod na tokeny.

03

Dodaj ją do App Store

Cal.com ma otwarty kod źródłowy: utwórz wpis swojej aplikacji w packages/app-store za pomocą yarn create-app, a potem otwórz pull request w calcom/cal.com. Przewodnik przeprowadzi Cię przez cały proces.

Proś tylko o to, czego potrzebuje Twoja aplikacja

Użytkownicy widzą każdy zakres na ekranie zgody, zanim go zaakceptują, a token może dotrzeć tylko do endpointów objętych jego zakresami.

01

Użytkownik

Własne konto użytkownika: BOOKING_*, EVENT_TYPE_*, SCHEDULE_*, APPS_*, PROFILE_*, WEBHOOK_* i INSIGHTS_READ.

02

Zespół

Zespoły, do których należą, z zakresami TEAM_*: zespołowe linki do planowania, rezerwacje, harmonogramy i członkostwa.

03

Organizacja

Dostęp w całej organizacji z zakresami ORG_*. Każdy z nich przyznaje też odpowiadający mu zakres TEAM_*.

Potrzebujesz planowania pod własną marką w swojej aplikacji?

Skorzystaj z coss.com Scheduling, stworzonego przez zespół Cal.com. To infrastruktura, która obsługuje miliony rezerwacji — pod twoją marką i dla twoich użytkowników.

coss.scheduling.bookings.create()

const result = await coss.scheduling.bookings.create({
  event_type: eventTypeId,
  start: "2026-03-10T14:00:00Z",
  attendee: {
    uid: "customer_77",
    name: "Sam Lee",
    email: "[email protected]",
    time_zone: "America/New_York",
  },
});
if (result.error?.code === "slot_unavailable") {
  // Someone got there first: show the times again.
}

Trial lesson with Ana Reyes

30 minutes, 10 minute buffer

confirmed
Ana Reyes's week: open times, times busy on a connected calendar, and bookings
TimeMon 9Tue 10Wed 11Thu 12Fri 13
09:00busyopenbookedopenopen
10:00openSamopenbusyopen
11:00openopenbusyopenopen
13:00bookedopenopenbookedopen
14:00openbusyopenbookedopen
15:00openbusyopenopenbusy
OpenBusy on calendarBooked
  1. confirmedCalendar invitations to Sam and Ana
  2. scheduling.booking.confirmed

Pytania o tworzenie na Cal.com

Krótkie odpowiedzi znajdziesz tutaj. O wszystko inne zapytaj poniżej.

Zadaj pytanie

Połącz swoją aplikację z Cal.com

Utwórz klienta OAuth, dodaj przycisk i pokaż swoją aplikację każdemu użytkownikowi Cal.com.

Utwórz klienta OAuthPrzeczytaj dokumentację OAuth