Skip to main content
Whop udfaser to ældre API’er. Begge flyttes til Current API på https://api.whop.com/api/v1 med de samme API-nøgler.

Skift til Current API

1

Behold din API-nøgle

Current API bruger de samme API-nøgler til konti og apps. Hvis en anmodning returnerer 403, mangler nøglen den tilladelse, som endpointet kræver. Tilføj den under Developer → API keys, eller anmod om den i din apps tilladelser.
2

Installér SDK'et, og fastlås en version

De officielle SDK’er kalder Current API og sender den API-version, de blev bygget mod. Hvis du bruger @whop/api, skal du erstatte den med @whop/sdk. Dens hjælpefunktioner withUser og withCompany har ingen tilsvarende: angiv i stedet bruger- eller konto-ID’et på hver anmodning.
Hvis du kalder API’et uden et SDK, skal du sende Api-Version-Date på hver anmodning. API-versioner forklarer fastlåsning.
3

Erstat hvert kald

Brug fanen for det API, du forlader, og fjern derefter den gamle basis-URL eller pakke fra din kode.

Find dine v2-kald

Hvert v2-svar har tre headere:Log svar, der indeholder Deprecation, for at finde alle v2-kald, din integration stadig foretager.

Rutekort

Medlemskaber og licenser

Medlemmer og kunder

Betalinger og checkout

Produkter og planer

Planer hedder nu varianter. Variant-ID’er beholder præfikset plan_, så gemte ID’er virker stadig.

Konto, experiences, anmeldelser og webhooks

Hvad der er ændret fra v2

Delvise opdateringer

v2 opdaterede en ressource med POST /resource/{id}. Current API bruger PATCH /resource/{id} og ændrer kun de felter, du sender.

Licensnøgler

v2’s validate_license tjekkede en nøgle og bandt den til en maskine i ét kald. I Current API henter din server medlemskabet ud fra licensnøglen, tjekker dets status og skriver et hardware-ID til metadata, første gang nogen bruger nøglen. SaaS-guiden har det fulde eksempel.Hold disse kald på din server. Din kontos API-nøgle kan ændre ethvert medlemskab i din virksomhed, så send den aldrig med i software, der kan downloades.

Webhooks i v2-formatet

Webhooks oprettet via v2 bliver ved med at sende payloads i v2-format. For at modtage det aktuelle format skal du oprette en ny webhook fra dashboardet eller med POST /webhooks, flytte din handler til den og derefter slette v2-webhooken. Webhooks dækker signaturtjek og hændelsestyper.

Paginering

v2 paginerede med page og per og returnerede pagination.current_page og pagination.total_page. Lister i Current API returnerer et data-array og et page_info-objekt. Angiv first for at sætte sidestørrelsen og after med den forrige page_info.end_cursor for at få den næste side. Stop, når page_info.has_next_page er false. SDK’erne paginerer for dig.

Næste trin

API-versioner

Fastlås en version, så senere ændringer aldrig ødelægger din integration.

Webhooks

Verificér signaturer, håndtér det aktuelle hændelsesformat, og modtag chatbeskeder i stedet for at polle.

Administrér medlemskaber

Annullér, sæt på pause, forlæng og opdatér medlemskaber.

App-visninger

Tjek medlemmers adgang i experience- og dashboard-visninger.