Skip to main content
Whop retire deux anciennes API. Toutes deux sont remplacées par la Current API à l’adresse 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 @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.
Si vous appelez l’API sans SDK, envoyez 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.

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éfixe plan_, 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 avec POST /resource/{id}. La Current API utilise PATCH /resource/{id} et ne modifie que les champs que vous envoyez.

Clés de licence

Le validate_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 avec POST /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 avec page 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.