Skip to main content
Les apps utilisent des autorisations pour accéder aux données du compte et agir au nom des utilisateurs. Chaque appel API nécessite l’autorisation correspondante. Vous déclarez celles dont vous avez besoin dans les paramètres de votre app, les créateurs les approuvent lors de l’installation, et vos appels SDK ne réussissent qu’une fois que les créateurs ont accordé ces autorisations.
Retrouvez les autorisations requises pour n’importe quel endpoint dans la référence API. Chaque page d’opération les liste sous « Required permissions ».

Autorisations requises et facultatives

Vous pouvez marquer chaque autorisation comme requise ou facultative. Ce choix modifie l’expérience d’installation pour les créateurs. Les autorisations facultatives conviennent bien aux fonctionnalités sur option. Si un créateur refuse une autorisation facultative, votre app doit continuer à fonctionner, simplement sans cette fonctionnalité.

Configurer les autorisations

Le flux d’autorisations est obligatoire, même pour tester sur votre propre compte. Le flux est le même à l’installation et en auto-test, ce qui vous permet de repérer tôt les scopes manquants.
1

Ouvrez l'onglet des autorisations de votre app

  1. Accédez au tableau de bord développeur.
  2. Sélectionnez ou créez une app.
  3. Sélectionnez l’onglet Permissions.
Paramètres des autorisations
2

Ajoutez les autorisations dont vous avez besoin

Sélectionnez Add permissions, choisissez ce dont votre app a besoin, puis confirmez.Comparez avec les endpoints API que vous prévoyez d’appeler et ajoutez toutes les autorisations qu’ils exigent.
3

Configurez chaque autorisation

Pour chacune :
  1. Rédigez une courte justification expliquant pourquoi l’app en a besoin. Les créateurs la voient lors de l’installation, et chaque autorisation doit avoir sa propre justification pour respecter les exigences de publication sur l’App Store.
  2. Marquez-la comme requise ou facultative.
Justification des autorisations
4

Enregistrez

Enregistrer les paramètres des autorisations
5

Installez sur un compte de test

Ouvrez votre lien d’installation direct : https://whop.com/apps/app_xxxxxxxxx/install.Choisissez un compte, examinez la demande d’autorisations, puis approuvez.
Demande d'autorisations

Mettre à jour les autorisations ultérieurement

Les autorisations peuvent évoluer avec l’app. Lorsque vous en ajoutez une nouvelle :
  • Les installations existantes voient un bouton Re-approve à côté de votre app.
  • Les appels API qui nécessitent la nouvelle autorisation échouent tant que chaque créateur ne l’a pas réapprouvée.
Lorsque vous ajoutez une autorisation, réapprouvez-la aussi sur votre propre compte de test. Les nouveaux scopes ne sont pas appliqués tant que vous ne les avez pas acceptés dans Authorized apps.
Les créateurs peuvent gérer à tout moment les autorisations accordées dans Dashboard → Settings → Authorized apps.

Questions fréquentes

Jusqu’à 100 par app.
Chaque endpoint de la référence API liste directement ses autorisations requises.
Autorisations dans la référence SDK
Oui. Vous pouvez demander des autorisations supplémentaires et le créateur sera invité à les réapprouver.
Tant que les autorisations n’ont pas été réapprouvées, les requêtes API nécessitant les autorisations nouvellement demandées échoueront. Assurez-vous que votre code gère ces erreurs et propose une solution de repli utile.
Pendant le développement de votre app, veillez à réapprouver vous-même les autorisations dans vos paramètres Authorized apps.Consultez Configurer vos autorisations pour plus d’informations.

Étapes suivantes

Authentification

Vérifiez l’utilisateur à l’origine d’une requête et contrôlez son niveau d’accès.

Écouter les webhooks

Recevez les événements de paiement, d’adhésion et d’inscription. Les webhooks nécessitent leurs propres scopes webhook_receive:*.

Suivre les installations

Sachez quand un compte installe ou supprime votre app, et associez-le à vos propres enregistrements.

Créer des vues d'app

Configurez les vues du tableau de bord, les expériences et les fiches Discover.

Lancer un proxy de développement local

Reproduisez en localhost la configuration iframe + cookie de production.