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 Roep je de API aan zonder SDK, stuur dan bij elk verzoek
@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.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.
- API v2
- Public GraphQL
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 prefixplan_, 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 metPOST /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 metPOST /webhooks, verplaats je je handler daarnaartoe en verwijder je daarna de v2-webhook. Webhooks behandelt handtekeningcontroles en eventtypen.Paginering
v2 pagineerde metpage 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.

