Erstellen von Shopify-Apps: Ein Entwicklerhandbuch für das Shopify-App-Ökosystem

Der Shopify App Store hostet über 10.000 Apps und generiert Milliardenumsätze für Entwickler. Unabhängig davon, ob Sie eine benutzerdefinierte App für einen einzelnen Händler oder eine öffentliche App für Tausende von Geschäften erstellen, ist es wichtig, die App-Architektur, APIs und das Ökosystem von Shopify zu verstehen. Dieser Leitfaden behandelt alles, was Entwickler wissen müssen, um Shopify-Apps im Jahr 2026 zu erstellen, zu starten und zu skalieren.

F: Welche Arten von Shopify-Apps können Sie erstellen?

Es gibt drei Arten von Shopify-Apps: öffentliche Apps, die im Shopify App Store aufgeführt sind und von jedem Händler installiert werden können, benutzerdefinierte Apps, die für einen einzelnen bestimmten Shop erstellt wurden, und Entwurfs-Apps, die während der Entwicklung und beim Testen verwendet werden. Öffentliche Apps durchlaufen den Überprüfungsprozess von Shopify, während benutzerdefinierte Apps direkt über den Administrator des Shops installiert werden.

App-Typen erklärt

Öffentliche Apps

Öffentliche Apps werden im Shopify App Store aufgeführt und können von jedem Shopify-Händler installiert werden. Sie verwenden OAuth zur Authentifizierung und müssen die Richtlinien zur App-Überprüfung von Shopify einhalten.

Eigenschaften:

• Verfügbar für alle über 4,8 Millionen Shopify-Shops
• Einnahmen durch Abonnements, Nutzungsgebühren oder einmalige Käufe
• Muss den App-Überprüfungsprozess von Shopify bestehen
• Verwenden Sie OAuth 2.0 für die Händlerauthentifizierung
• Vorbehaltlich der App Store-Richtlinien und Qualitätsstandards von Shopify

Benutzerdefinierte Apps

Benutzerdefinierte Apps werden für einen einzelnen Store erstellt und durchlaufen nicht den App Store-Überprüfungsprozess. Sie werden direkt über das Admin-Panel des Shops installiert.

Eigenschaften:

• Für einen bestimmten Händler entwickelt
• Kein Eintrag im App Store erforderlich
• Im Shopify-Adminbereich generierte Zugriffstoken – Kein OAuth-Flow erforderlich
• Ideal für maßgeschneiderte Geschäftslogik und Integrationen

Entwurfs-Apps

Entwurfs-Apps werden während der Entwicklung verwendet. Sie funktionieren wie öffentliche Apps, können aber nur in Development Stores installiert werden. Sie werden bei der Übermittlung an den App Store in öffentliche Apps umgewandelt.

Einrichten Ihrer Entwicklungsumgebung

Shopify-CLI

Shopify CLI ist das offizielle Befehlszeilentool für die App-Entwicklung. Es baut Projekte auf, verwaltet Entwicklungsspeicher und kümmert sich um die App-Bereitstellung.

Erste Schritte:

1. Installieren Sie Node.js 18+ und npm
2. Shopify CLI installieren: npm install -g @shopify/cli @shopify/app
3. Erstellen Sie eine neue App: shopify app init
4. Wählen Sie Ihr Framework (Remix ist die standardmäßige und empfohlene Wahl)
5. Entwicklung starten: shopify app dev

Die CLI richtet automatisch Ngrok-Tunnel für die lokale Entwicklung ein, verwaltet die App-Authentifizierung und ermöglicht das Neuladen von Modulen im laufenden Betrieb.

Entwicklungsspeicher

Erstellen Sie über Ihr Shopify-Partner-Dashboard einen kostenlosen Entwicklungsshop. Development Stores haben vollen Zugriff auf alle Shopify-Funktionen und erfordern keinen kostenpflichtigen Plan. Sie können eine unbegrenzte Anzahl von Entwicklungsshops zum Testen erstellen.

Shopify-APIs

Shopify bietet mehrere APIs für verschiedene Anwendungsfälle:

| API | Authentifizierung | Anwendungsfall | |-----|---------------|----------| | Admin-API (REST) ​​| OAuth/Zugriffstoken | Filialverwaltung, Bestellungen, Produkte, Kunden | | Admin-API (GraphQL) | OAuth/Zugriffstoken | Wie REST, aber mit flexibler Abfrage | | Storefront-API | Storefront-Zugriffstoken | Kundenorientierte Funktionen, Headless Commerce | | Checkout-API | Checkout-Zugriffstoken | Benutzerdefinierte Checkout-Erlebnisse (nur Plus) | | Zahlungs-Apps-API | Anmeldedaten des Partners | Integration des Zahlungsgateways | | Funktionen-API | Wasm-Module | Benutzerdefinierte Rabatte, Versand, Validierungslogik |

Admin-API

Die Admin-API ist die primäre Schnittstelle zum Verwalten von Geschäftsdaten. Es bietet Zugriff auf Produkte, Bestellungen, Kunden, Lagerbestände, Erfüllung und mehr.

GraphQL vs. REST:

Shopify empfiehlt die GraphQL Admin API für Neuentwicklungen. Zu den Vorteilen gehören:

• Fordern Sie genau die Felder an, die Sie benötigen (kein übermäßiges Abrufen)
• Rufen Sie verwandte Ressourcen in einer einzigen Anfrage ab
• Stark typisiertes Schema mit Selbstbeobachtung
• Bessere Ratenlimitauslastung (kostenbasiert statt anfragebasiert)

GraphQL-Beispiel – Produkte abrufen:

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        variants(first: 5) {
          edges {
            node {
              price
              inventoryQuantity
            }
          }
        }
      }
    }
  }
}

Ratenbegrenzungen:

• GraphQL Admin API: 1.000 Kostenpunkte pro Sekunde (jedes Feld hat Kosten)
• REST Admin API: 40 Anfragen pro Sekunde (Basic/Shopify), 80 (Advanced/Plus)
• Storefront API: 100 Kostenpunkte pro Sekunde

Storefront-API

Die Storefront-API ist für kundenorientierte Erlebnisse konzipiert. Es bietet unauthentifizierten Zugriff auf Produkte, Sammlungen und Warenkorbfunktionen. Verwenden Sie es beim Bauen:

• Benutzerdefinierte Storefronts (Headless Commerce)
• Mobile Apps
• Kaufen Sie auf externen Websites eingebettete Schaltflächen
• Produktempfehlungs-Widgets

Webhooks

Webhooks benachrichtigen Ihre App, wenn im Shop eines Händlers Ereignisse auftreten. Anstatt die API abzufragen, sendet Shopify HTTP-POST-Anfragen an Ihren Endpunkt, wenn sich Daten ändern.

Unverzichtbare Webhooks für die meisten Apps:

• orders/create – Neue Bestellung aufgegeben
• orders/updated – Bestellstatus geändert
• products/update – Produktdaten geändert
• products/delete – Produkt entfernt
• app/uninstalled – Der Händler hat Ihre App deinstalliert
• shop/update – Speichereinstellungen geändert

Best Practices für Webhooks:

1. Schnell reagieren – Geben Sie innerhalb von 5 Sekunden einen 200-Status zurück; Daten asynchron verarbeiten
2. Duplikate verarbeiten – Shopify sendet möglicherweise denselben Webhook mehrmals; Idempotenz implementieren
3. Signaturen überprüfen – Validieren Sie den X-Shopify-Hmac-SHA256-Header, um die Authentizität zu bestätigen
4. Retry-Logik implementieren – Wenn Ihr Endpunkt ausfällt, versucht Shopify innerhalb von 48 Stunden bis zu 19 Mal erneut
5. Verwenden Sie obligatorische Webhooks – Registrieren Sie app/uninstalled, customers/data_request, customers/redact und shop/redact für die Einhaltung

Erstellen einer App-Benutzeroberfläche mit App Bridge und Polaris

Shopify App Bridge

App Bridge ermöglicht die Darstellung der Benutzeroberfläche Ihrer App im Shopify-Adminbereich. Es bietet:

• Navigationsintegration mit der Admin-Seitenleiste von Shopify
• Modale Dialoge, Toastbenachrichtigungen und Ladebalken
• Ressourcenauswahl zur Auswahl von Produkten, Kollektionen und Kunden
• Titelleiste mit primären und sekundären Aktionen

Polaris Design System

Polaris ist die React-Komponentenbibliothek von Shopify. Es bietet vorgefertigte UI-Komponenten, die der Admin-Designsprache von Shopify entsprechen:

• Formulare, Schaltflächen und Eingabefelder
• Datentabellen und Ressourcenlisten
• Karten, Banner und Layoutkomponenten
• Datumsauswahl, Filter und Paginierung

Durch die Verwendung von Polaris wird sichergestellt, dass sich Ihre App im Shopify-Adminbereich nativ anfühlt und die Designprüfung besteht.

Shopify-Funktionen

Mit Shopify-Funktionen können Sie mithilfe von WebAssembly (Wasm) benutzerdefinierte Geschäftslogik auf der Shopify-Infrastruktur ausführen. Sie ersetzen ältere Skripteditor-Skripte und werden an wichtigen Punkten im Handelsfluss ausgeführt:

• Rabattfunktionen – Benutzerdefinierte Rabattlogik (BOGO, gestaffelte Preise, Mengenrabatte)
• Versandfunktionen – Individuelle Versandtarife und Lieferoptionen
• Zahlungsfunktionen – Zahlungsmethoden an der Kasse ausblenden oder neu anordnen
• Validierungsfunktionen – Benutzerdefinierte Warenkorb- und Checkout-Validierungsregeln
• Fulfillment-Funktionen – Benutzerdefinierte Routing des Fulfillment-Standorts

Funktionen werden in weniger als 5 ms ausgeführt und auf den Servern von Shopify ausgeführt. Dadurch wird sichergestellt, dass sie unabhängig von der Storefront-Technologie (Flüssigkeit, Wasserstoff oder Drittanbieter) funktionieren.

Der App-Review-Prozess

Öffentliche Apps müssen die Prüfung von Shopify bestehen, bevor sie im App Store angeboten werden. Die Rezension bewertet:

Technische Anforderungen: – Die App muss die neuesten Versionen der Shopify-APIs verwenden – Korrekte OAuth-Implementierung mit korrekten Bereichen

• HTTPS für alle Endpunkte
• Obligatorische Webhook-Handler für die Einhaltung der DSGVO
• Fehlerbehandlung und ordnungsgemäße Verschlechterung

Anforderungen an die Benutzererfahrung:

• Verwenden Sie Polaris-Komponenten für die Admin-Benutzeroberfläche
• Bereitstellung klarer Onboarding- und Einrichtungsanweisungen
• Fügen Sie einen Hilfe-/Support-Link in die App ein
• Responsives Design für alle Admin-Bildschirmgrößen

Geschäftsanforderungen:

• Klare und genaue Auflistung im App Store
• Transparente Preisgestaltung und Abrechnung
• Datenschutzbestimmungen und Nutzungsbedingungen
• Supportkanal mit angemessenen Reaktionszeiten

Häufige Ablehnungsgründe:

1. Anfordern unnötiger API-Berechtigungsbereiche
2. Fehlende DSGVO-Webhook-Handler
3. Schlechte Benutzeroberfläche, die nicht den Polaris-Richtlinien entspricht
4. Unzureichende Fehlerbehandlung
5. Funktionsstörungen während der Überprüfung

Der Überprüfungsprozess dauert in der Regel 7–14 Werktage. Gehen Sie umgehend auf Feedback ein – Shopify bietet spezifische Anleitungen zu erforderlichen Änderungen.

Monetarisierungsstrategien

Shopify unterstützt über die Billing API mehrere Abrechnungsmodelle:

| Modell | Am besten für | Beispiel | |-------|----------|---------| | Monatsabonnement | Kernfunktionen der App | 9,99 $/Monat für Basic, 29,99 $/Monat für Pro | | Jahresabonnement | Engagierte Kunden | 99 $/Jahr (Rabatt gegenüber monatlich) | | Nutzungsbasierte Abrechnung | Variabler Verbrauch | 0,01 $ pro API-Aufruf oder gesendeter E-Mail | | Einmalige Gebühr | Lebenslanger Zugriff | 49,99 $ einmaliger Kauf | | Freemium | Benutzerakquise | Kostenloses Kontingent mit kostenpflichtigen Upgrades |

Preistipps:

• Shopify übernimmt eine Umsatzbeteiligung von 15 % auf die erste Million US-Dollar Umsatz, dann 0 % (gemäß den aktuellen Bedingungen des Partnerprogramms).
• Bieten Sie eine kostenlose Testversion an (7–14 Tage sind Standard)
• Schaffen Sie eine klare Wertdifferenzierung zwischen den Preisstufen – Erwägen Sie eine nutzungsbasierte Preisgestaltung für Apps mit variablem Ressourcenverbrauch

Prüfung und Qualitätssicherung

Bevor Sie Ihre App zur Überprüfung einreichen:

1. Unit-Tests – Testen Sie die Kerngeschäftslogik isoliert
2. Integrationstests – Testen Sie API-Interaktionen mit dem Entwicklungsshop von Shopify
3. UI-Tests – Überprüfen Sie, ob Polaris-Komponenten korrekt gerendert werden
4. Webhook-Tests – Validieren Sie die Webhook-Verarbeitung mit Testnutzlasten
5. Leistungstests – Stellen Sie sicher, dass API-Aufrufe unter Last innerhalb der Ratengrenzen bleiben
6. Sicherheitsaudit – Auf XSS-, CSRF- und Injektionsschwachstellen prüfen
7. OAuth-Flow-Test – Installation, Authentifizierung und Deinstallation überprüfen

Verwenden Sie das Partner-Dashboard von Shopify, um verschiedene Shop-Konfigurationen und Plantypen zu simulieren.

Professionelle App-Entwicklung

Für die Erstellung einer Shopify-App sind Fachkenntnisse in React, GraphQL, Node.js und den spezifischen Plattformmustern von Shopify erforderlich. ECOSIRE bietet professionelle [Shopify-App-Entwicklungsdienste] (/services/shopify/app-development) für Unternehmen, die benutzerdefinierte Funktionen benötigen, die über das Angebot bestehender Apps hinausgehen.

Ganz gleich, ob Sie eine benutzerdefinierte App für Ihren eigenen Shop benötigen oder eine öffentliche App für das Shopify-Ökosystem erstellen möchten, unser Entwicklungsteam kümmert sich um Architektur, Entwicklung, Tests und Einreichung im App Store. Wir bieten auch Automatisierungslösungen an, die sich in die APIs und Webhooks von Shopify integrieren lassen.

Kontaktieren Sie unser Team, um Ihr Shopify-App-Entwicklungsprojekt zu besprechen.

Wichtige Erkenntnisse

• Shopify bietet drei App-Typen: öffentlich (App Store), benutzerdefiniert (einzelner Store) und Entwurf (Entwicklung). – Für Neuentwicklungen wird die GraphQL Admin API gegenüber REST empfohlen – Webhooks ermöglichen eine Echtzeit-Ereignisverarbeitung ohne Abfrage – Shopify-Funktionen führen über WebAssembly benutzerdefinierte Geschäftslogik auf der Shopify-Infrastruktur aus
• App Bridge und Polaris sorgen dafür, dass sich Ihre App nahtlos in den Shopify-Administrator integriert
• Der App-Überprüfungsprozess dauert 7–14 Tage und bewertet technische Qualität, UX und Geschäftsanforderungen
• Monetarisieren Sie durch Abonnements, nutzungsbasierte Abrechnung oder einmalige Gebühren über die Billing API