Skip to main content
Brug OAuth 2.1 + PKCE med OpenID Connect (OIDC) til at lade brugere logge ind med Whop på dit website eller i din app. De returnerede adgangstokens giver dig adgang til data og lader dig handle på vegne af disse brugere.
OAuth-endpoints findes på https://api.whop.com/oauth/.

Trin 1: Opret din OAuth-app

App-objektet, som apps.create returnerer i den nuværende @whop/sdk, eksponerer ikke et client_secret-felt. Kopiér i stedet klienthemmeligheden fra fanen Dashboard.
Brug endpointet Create App til at oprette en OAuth-app programmatisk:
Opdater redirect-URI’er senere med endpointet Update App.

Trin 2: Send brugere til godkendelse

Brug PKCE i din web- eller mobilklient til sikkert at omdirigere brugere til Whops OAuth-forløb.
Kald startWhopOAuth for at omdirigere brugeren:
Hvis brugeren ikke er logget ind, beder Whop om login og viser derefter samtykkeskærmen. Hvis brugeren allerede har godkendt din applikation til de anmodede scopes, omdirigeres vedkommende automatisk tilbage uden at skulle bekræfte to gange.
Hvis du sender et konto-ID som company_id, er tokens afgrænset til den konto for brugeren. Du kan kun få adgang til de ressourcer, som brugeren kan styre på den Whop-konto.

Trin 3: Håndter callbacket, og byt koden

Whop omdirigerer tilbage til din redirect_uri med code og state. Brug denne funktion til at verificere state, bytte koden til tokens og hente legitimationsoplysninger:
På din callback-side:

Trin 4: Brug tokens

Initialiser Whop SDK’et med brugerens adgangstoken:
Se API-referencen for alle tilgængelige endpoints.

Trin 5: Forny tokens

Adgangstokens udløber efter 1 time. Brug refresh-tokenet til at få nye legitimationsoplysninger:
Brug:
Refresh-tokens roteres ved hver brug. Gem altid de nye tokens, der returneres fra refresh-endpointet. Hvis du angav company_id under godkendelsen, skal du angive det samme company_id, når du fornyer.

Trin 6: Userinfo og tilbagekaldelse

Hent brugeroplysninger

Hent den godkendte brugers profil via userinfo-endpointet:
De returnerede felter afhænger af de givne scopes. openid er påkrævet, profile tilføjer navn/brugernavn/billede, email tilføjer e-mailfelter.

Tilbagekald tokens ved logout

Når en bruger logger ud, skal du tilbagekalde vedkommendes refresh-token. Adgangstokens udløber efter 1 time og kan ikke tilbagekaldes på serveren.
Tilbagekald altid tokens, når brugere logger ud. Det ugyldiggør refresh-tokenet med det samme og forhindrer uautoriseret adgang, selv hvis tokenet er kompromitteret.

Fejlhåndtering

OAuth-fejl følger standardformatet:
Almindelige fejlkoder:
  • invalid_request: manglende eller ugyldig parameter.
  • invalid_grant: kode eller token er udløbet eller tilbagekaldt.
  • invalid_client: ukendt client_id.
  • insufficient_scope: tokenet har ikke det påkrævede scope.
  • rate_limit_exceeded: for mange requests (tjek headeren Retry-After).

Næste trin

API-reference

Alle endpoints, et givet adgangstoken kan kalde.

Modtag betalinger

Kombiner login med checkout for komplette købsforløb.

Lyt til webhooks

Reager på events for betalinger, medlemskaber og tilmeldinger på serversiden.

Anmod om tilladelser

Konfigurer de OAuth-scopes, din app rent faktisk har brug for.