Skip to main content

Verwenden der GitHub Marketplace-API in Ihrer App

Hier erfährst du, wie du die GitHub Marketplace-API und Webhook-Ereignisse mit deiner App für den GitHub Marketplace integrierst.

REST-Endpunkte für die GitHub Marketplace-API

Um deine App in GitHub Marketplace zu verwalten, verwende diese GitHub Marketplace-API-Endpunkte.

Webhook-Ereignisse für die GitHub Marketplace-API

Eine GitHub Marketplace-App empfängt Informationen zu Änderungen am Plan eines Benutzers aus dem Marketplace-Kaufereignis-Webhook. Ein Marketplace-Kaufereignis wird ausgelöst, wenn ein Benutzer seinen Zahlungsplan kauft, abbricht oder ändert.

Testen der App

GitHub empfiehlt, Ihre App mit APIs und Webhooks zu testen, bevor Sie Ihren Eintrag an GitHub Marketplace übermitteln, damit Sie eine ideale Benutzererfahrung für Kunden bieten können. Bevor ein Onboarding-Experte deine App genehmigt, muss sichergestellt werden, dass sie die Abrechnungsflüsse korrekt verarbeitet.

Verwaltung von neuen Käufen und kostenlosen Testversionen

Wenn ein Kunde einen kostenpflichtigen Plan, eine kostenlose Testversion oder die kostenlose Version deiner GitHub Marketplace-App erwirbt, wird der marketplace_purchase-Ereigniswebhook mit der purchased-Aktion ausgelöst, der den Kaufprozess startet.

Behandeln von Planänderungen

Durch das Up- oder Downgrade einer GitHub Marketplace-App wird das marketplace_purchase-Webhook-Ereignis mit der changed-Aktion ausgelöst, die den Upgrade- oder Downgrade-Prozess startet.

Umgang mit Planstornierungen

Durch die Kündigung einer GitHub Marketplace-App wird der marketplace_purchase-Ereigniswebhook mit der Aktion cancelled ausgelöst, wodurch der Kündigungsprozess gestartet wird.