Skip to main content

Test de votre application

GitHub recommande de tester votre application avec des API et des webhooks avant de soumettre votre référencement à GitHub Marketplace afin de pouvoir proposer une expérience idéale pour les clients. Avant qu’un expert d’intégration approuve votre application, celle-ci doit gérer correctement les flux de facturation.

Remarque : cet article s’applique à la publication d’applications dans GitHub Marketplace uniquement. Pour plus d’informations sur la publication de GitHub Actions dans GitHub Marketplace, consultez « Publication d’actions dans GitHub Marketplace ».

Test d’applications

Vous pouvez utiliser un brouillon de listing GitHub Marketplace pour simuler chacun des flux de facturation. Un listing à l’état de brouillon signifie qu’il n’a pas été envoyé pour approbation. Les achats que vous faites avec un brouillon de listing GitHub Marketplace ne créent pas de transactions réelles, et GitHub ne débite pas votre carte de crédit. Notez que vous pouvez simuler des achats uniquement pour les plans publiés dans le brouillon de listing et non pour les brouillons de plan. Pour plus d’informations, consultez « Créer un brouillon de référencement pour votre application » et « Utilisation de l’API GitHub Marketplace dans votre application ».

Utilisation d’une application de développement avec un brouillon de listing pour tester des changements

Un listing GitHub Marketplace peut être associé à une seule inscription d’application, et chaque application peut accéder seulement à son propre listing GitHub Marketplace. Pour ces raisons, nous vous recommandons de configurer une application de développement distincte, avec la même configuration que votre application de production, et de créer un brouillon de listing GitHub Marketplace pour les tests. Le brouillon de listing GitHub Marketplace vous permet de tester les changements sans affecter les utilisateurs actifs de votre application de production. Vous n’avez jamais besoin d’envoyer votre listing GitHub Marketplace de développement, car vous ne l’utilisez que pour les tests.

Comme vous pouvez uniquement créer des brouillons de listing GitHub Marketplace pour les applications publiques, vous devez rendre publique votre application de développement. Les applications publiques ne sont pas découvrables en dehors des listings GitHub Marketplace publiés si vous ne partagez pas l’URL de l’application. Un listing Marketplace à l’état de brouillon est visible seulement par le propriétaire de l’application.

Dès que vous avez une application de développement avec un brouillon de listing, vous pouvez l’utiliser pour tester les changements que vous faites sur votre application pendant l’intégration aux webhooks et à l’API GitHub Marketplace.

N’effectuez pas d’achats de test avec une application qui est active dans GitHub Marketplace.

Simulation d’événements d’achat Marketplace

Vos scénarios de test peuvent nécessiter la configuration de plans de listing qui offrent des essais gratuits, et la possibilité de basculer entre les abonnements gratuits et payants. Comme les rétrogradations et les annulations deviennent effectifs seulement au prochain cycle de facturation, GitHub offre une fonctionnalité pour développeur uniquement, « Appliquer un changement en attente », qui permet de forcer la mise en application immédiate des actions de plan changed et cancelled. Vous pouvez accéder à Appliquer un changement en attente pour les applications avec des brouillons de listing Marketplace dans https://github.com/settings/billing#pending-cycle:

Test d’API

Pour la plupart des points de terminaison d’API GitHub Marketplace, nous fournissons également des points de terminaison d’API stubbés qui retournent des données factices codées en dur que vous pouvez utiliser pour les tests. Pour recevoir des données stubbées, vous devez spécifier des URL stubbées, qui ont /stubbed dans la route (par exemple, /user/marketplace_purchases/stubbed). Pour obtenir la liste des points de terminaison qui prennent en charge cette approche de données stubbées, consultez Points de terminaison GitHub Marketplace.

Test de webhooks

GitHub fournit des outils pour tester vos charges utiles déployées. Pour plus d’informations, consultez « Test de webhooks ».