Skip to main content
Whop stopt met twee oudere API’s. Beide gaan over naar de Current API op https://api.whop.com/api/v1, met dezelfde API-sleutels.

Overstappen naar de Current API

1

Behoud je API-sleutel

De Current API gebruikt dezelfde API-sleutels voor accounts en apps. Als een verzoek 403 retourneert, mist de sleutel de machtiging die dat endpoint nodig heeft. Voeg die toe onder Developer → API keys, of vraag hem aan in de machtigingen van je app.
2

Installeer de SDK en pin een versie

De officiële SDK’s roepen de Current API aan en sturen de API-versie mee waarvoor ze zijn gebouwd. Gebruik je @whop/api, vervang die dan door @whop/sdk. De helpers withUser en withCompany daarvan hebben geen equivalent: geef in plaats daarvan bij elk verzoek de gebruikers- of account-ID mee.
Roep je de API aan zonder SDK, stuur dan bij elk verzoek Api-Version-Date mee. API-versies legt uit hoe pinnen werkt.
3

Vervang elke aanroep

Gebruik het tabblad voor de API die je verlaat en verwijder daarna de oude basis-URL of het oude pakket uit je code.

Je v2-aanroepen vinden

Elke v2-respons bevat drie headers:Log responsen die Deprecation bevatten om elke v2-aanroep te vinden die je integratie nog doet.

Routeoverzicht

Lidmaatschappen en licenties

Leden en klanten

Betalingen en checkout

Producten en plannen

Plannen heten nu varianten. Variant-ID’s behouden de prefix plan_, dus opgeslagen ID’s blijven werken.

Account, experiences, reviews en webhooks

Wat er is veranderd ten opzichte van v2

Gedeeltelijke updates

v2 werkte een resource bij met POST /resource/{id}. De Current API gebruikt PATCH /resource/{id} en wijzigt alleen de velden die je meestuurt.

Licentiesleutels

validate_license in v2 controleerde een sleutel en koppelde die in één aanroep aan een machine. In de Current API haalt je server het lidmaatschap op aan de hand van de licentiesleutel, controleert de status ervan en schrijft een hardware-ID naar metadata de eerste keer dat iemand de sleutel gebruikt. De SaaS-gids bevat het volledige voorbeeld.Houd deze aanroepen op je server. Met de API-sleutel van je account kun je elk lidmaatschap in je bedrijf wijzigen, dus lever die nooit mee in downloadbare software.

Webhooks in het v2-formaat

Webhooks die via v2 zijn aangemaakt, blijven payloads in het v2-formaat versturen. Om het huidige formaat te ontvangen, maak je een nieuwe webhook aan vanuit het dashboard of met POST /webhooks, verplaats je je handler daarnaartoe en verwijder je daarna de v2-webhook. Webhooks behandelt handtekeningcontroles en eventtypen.

Paginering

v2 pagineerde met page en per en retourneerde pagination.current_page en pagination.total_page. Lijsten in de Current API retourneren een data-array en een page_info-object. Geef first mee om de paginagrootte in te stellen en after met de vorige page_info.end_cursor om de volgende pagina op te halen. Stop wanneer page_info.has_next_page false is. De SDK’s pagineren voor je.

Volgende stappen

API-versies

Pin een versie zodat latere wijzigingen je integratie nooit breken.

Webhooks

Verifieer handtekeningen, verwerk het huidige eventformaat en ontvang chatberichten in plaats van te pollen.

Lidmaatschappen beheren

Annuleer, pauzeer, verleng en werk lidmaatschappen bij.

App-weergaven

Controleer de toegang van leden in experience- en dashboardweergaven.