Shopify (new)

Dieses Dokument erklärt, wie du in Shopify eine private App erstellst, die Client-ID und den Client-Secret für den OAuth, sowie 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

Client-ID und Client-Secret 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 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.

5. App-Berechtigungen festlegen

• Wähle in der neuen Seite die Checkbox aus für "Embed app in Shopify admin"

• Füge die Scopes hinzu, die gewünscht sind oder entnehme die nachfolgenden Scopes.

• Klicke anschließend auf Release.

Diese Scopes bilden einen umfassenden Berechtigungsrahmen ab, der die gängigen Standard-Use-Cases im E-Commerce vollständig unterstützt.

read_all_orders,read_customer_events,read_customers,write_customers,read_discounts,write_draft_orders,read_draft_orders,read_files,read_fulfillments,write_fulfillments,read_inventory,read_orders,write_orders,read_products,read_returns,write_returns

6. App installieren

• Anschließend muss die App in dem zu unterstützenden Shop installiert werden.

• Gehe dazu auf den Menüpunkt "Home" und klicke auf "Install app"

Die App ist jetzt installiert.

7. API Zugangsdaten

• Um die Zugangsdaten für die API abzurufen gehe dazu auf den Menüpunkt "Settings".

• Kopiere folgende Werte raus:

  • Client ID

  • Secret

---

📋 Wichtige Scopes im Überblick

🔍 Anwendungsfall	⚙️ HTTP-Methode & Beschreibung	🔐 Benötigte Berechtigung (Scope)
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

• Eine Client ID und Client Secret generiert

• Die erforderlichen Scopes für deine Anwendung gesetzt

Damit ist dein Shopify-Store für API-Integrationen vorbereitet.