https://api.whop.com/api/v1, avec les mêmes clés API.
Passer à la Current API
1
Conservez votre clé API
La Current API utilise les mêmes clés API de compte et d’application. Si une requête renvoie
403, il manque à la clé la permission requise par cet endpoint. Ajoutez-la dans Developer → API keys, ou demandez-la dans les permissions de votre application.2
Installez le SDK et fixez une version
Les SDK officiels appellent la Current API et envoient la version d’API pour laquelle ils ont été conçus. Si vous utilisez Si vous appelez l’API sans SDK, envoyez
@whop/api, remplacez-le par @whop/sdk. Ses helpers withUser et withCompany n’ont pas d’équivalent : passez plutôt l’ID de l’utilisateur ou du compte à chaque requête.Api-Version-Date à chaque requête. Versions de l’API explique comment fixer une version.3
Remplacez chaque appel
Utilisez l’onglet correspondant à l’API que vous quittez, puis supprimez l’ancienne URL de base ou l’ancien paquet de votre code.
- API v2
- GraphQL public
Trouver vos appels v2
Chaque réponse v2 comporte trois en-têtes :Journalisez les réponses qui incluent
Deprecation pour retrouver chaque appel v2 que votre intégration effectue encore.Correspondance des routes
Adhésions et licences
Membres et clients
Paiements et checkout
Produits et plans
Les plans s’appellent désormais des variantes. Les ID de variantes conservent le préfixeplan_, donc les ID enregistrés fonctionnent toujours.Compte, expériences, avis et webhooks
Ce qui a changé depuis la v2
Mises à jour partielles
La v2 mettait à jour une ressource avecPOST /resource/{id}. La Current API utilise PATCH /resource/{id} et ne modifie que les champs que vous envoyez.Clés de licence
Levalidate_license de la v2 vérifiait une clé et l’associait à une machine en un seul appel. Dans la Current API, votre serveur récupère l’adhésion à partir de la clé de licence, vérifie son status et écrit un ID matériel dans metadata la première fois que quelqu’un utilise la clé. Le guide SaaS contient l’exemple complet.Conservez ces appels sur votre serveur. La clé API de votre compte peut modifier chaque adhésion de votre entreprise : ne l’intégrez donc jamais dans un logiciel téléchargeable.Webhooks au format v2
Les webhooks créés via la v2 continuent d’envoyer des payloads au format v2. Pour recevoir le format actuel, créez un nouveau webhook depuis le tableau de bord ou avecPOST /webhooks, déplacez-y votre gestionnaire, puis supprimez le webhook v2. Webhooks couvre la vérification des signatures et les types d’événements.Pagination
La v2 paginait avecpage et per et renvoyait pagination.current_page et pagination.total_page. Les listes de la Current API renvoient un tableau data et un objet page_info. Passez first pour définir la taille de la page et after avec le page_info.end_cursor précédent pour obtenir la page suivante. Arrêtez-vous lorsque page_info.has_next_page vaut false. Les SDK gèrent la pagination à votre place.
Étapes suivantes
Versions de l'API
Fixez une version pour que les changements ultérieurs ne cassent jamais votre intégration.
Webhooks
Vérifiez les signatures, gérez le format d’événement actuel et recevez les messages de chat au lieu d’interroger l’API en boucle.
Gérer les adhésions
Annulez, suspendez, prolongez et mettez à jour des adhésions.
Vues d'application
Vérifiez l’accès des membres dans les vues d’expérience et de tableau de bord.

