OAuth-endpoints findes på
https://api.whop.com/oauth/.Trin 1: Opret din OAuth-app
- API
- 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.startWhopOAuth for at omdirigere brugeren:
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 dinredirect_uri med code og state. Brug denne funktion til at verificere state, bytte koden til tokens og hente legitimationsoplysninger:
Trin 4: Brug tokens
Initialiser Whop SDK’et med brugerens adgangstoken:Trin 5: Forny tokens
Adgangstokens udløber efter 1 time. Brug refresh-tokenet til at få nye legitimationsoplysninger: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.Fejlhåndtering
OAuth-fejl følger standardformatet:invalid_request: manglende eller ugyldig parameter.invalid_grant: kode eller token er udløbet eller tilbagekaldt.invalid_client: ukendtclient_id.insufficient_scope: tokenet har ikke det påkrævede scope.rate_limit_exceeded: for mange requests (tjek headerenRetry-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.

