Shopify
Dieses Dokument erklärt, wie du in Shopify eine private App erstellst, API-Schlüssel generierst und die passenden Berechtigungen (Scopes) für deine API-Abfragen setzt.
🧰 Voraussetzungen
Ein aktiver Shopify-Account mit Zugriff auf den Adminbereich
Berechtigung zum Erstellen von Apps im Shop
Sicherer Speicherort für die API-Zugangsdaten
API-Schlüssel und Access Tokens sollten sicher aufbewahrt und niemals öffentlich geteilt werden.
⚙️ Schritt-für-Schritt-Anleitung: API-Key erstellen
1. Anmeldung im Shopify-Admin
Gehe zu: 👉 https://admin.shopify.com
Melde dich in deinem Shopify-Store an.
2. Navigieren zum App-Bereich
Klicke links unten im Adminbereich auf Settings.
Wähle Apps and sales channels aus.
3. Neue App erstellen
Klicke auf Develop apps.
Danach auf Create an app.
4. App-Informationen eingeben
Vergib einen App-Namen und klicke auf Create app.
Trage unter Notfall-Entwickler-E-Mail eine gültige Adresse ein.
5. App-Berechtigungen festlegen
Gehe in der App auf den Tab Configuration.
Klicke auf Admin API integration.
Wähle die benötigten Berechtigungen (Scopes) aus.
Klicke auf Save.
6. API-Credentials generieren
Öffne den Tab API credentials.
Unter Access tokens auf Install app klicken.
Shopify generiert nun die Zugangsdaten:
API-Key
Access Token (per Klick auf reveal token sichtbar)
Kopiere den Token und verwende ihn als X-Shopify-Token für API-Abfragen.
Die App ist jetzt erstellt. Der Access Token ist nur einmal sichtbar – sichere ihn sofort!
🧩 API-Berechtigungen (Scopes)
Um API-Abfragen auszuführen, müssen die entsprechenden Scopes freigegeben werden. Diese definieren, auf welche Daten und Funktionen die App zugreifen darf.
Vorgehen
Gehe zu den Einstellungen - Apps:
Gehe auf "Develop apps":
Klicke auf "create an app". Vergebe einen Namen und erstelle die App:
Gehe zu Configure Storefront API Scopes:
Setze die Scopes:
Speichere und gehe zu API Credentials:
Damit man die Access Tokens für Admin oder Storefront API bekommt muss die App installiert sein.
📋 Wichtige Scopes im Überblick
Kundendaten abrufen
GET /admin/api/2023-10/customers.json – Suche nach Kunden
read_customers (Admin API)
Alle Bestellungen eines Kunden abrufen
GET /admin/api/2023-10/customers/{customer_id}/orders.json
read_orders (Admin API)
Spezifische Bestellung abrufen
GET /admin/api/2023-10/orders/{order_id}.json
read_orders (Admin API)
Bestellungen nach Kriterien abrufen
GET /admin/api/2023-10/orders.json?status=any&created_at_min=...
read_orders (Admin API)
Bestellstatus (Fulfillments) abrufen
GET /admin/api/2023-10/orders/{order_id}/fulfillments.json
read_fulfillments (Admin API)
Bestellung stornieren
POST /admin/api/2023-10/orders/{order_id}/cancel.json
write_orders (Admin API)
Lieferadresse ändern
PUT /admin/api/2023-10/orders/{order_id}.json (mit aktualisierter Adresse im Payload)
write_orders (Admin API)
Rechnung per E-Mail senden
POST /admin/api/2023-10/orders/{order_id}/send_invoice.json
write_orders (Admin API)
Kundeneinladung senden
POST /admin/api/2023-10/customers/{customer_id}/send_invite.json
write_customers (Admin API)
Passwort zurücksetzen (Link)
mutation customerRecover
unauthenticated_write_customers (Storefront API)
Zahlungsart ändern
POST /admin/api/2023-10/customers/{customer_id}/payment_methods.json
write_customers, write_customer_payment_methods (Admin API)
✅ Ergebnis
Nach der Einrichtung hast du:
Eine private App im Shopify-Adminbereich erstellt
Einen API-Key und Access Token generiert
Die erforderlichen Scopes für deine Anwendung gesetzt
Damit ist dein Shopify-Store für API-Integrationen vorbereitet.
Zuletzt aktualisiert
War das hilfreich?