Anmeldeinformationen und Umgebungen#
Konfigurieren Sie die Zugangsdaten für Ihren Onlineshop mit Visualizer SDK und bei Bedarf für die Product Import API. Das Lesen der öffentlichen Dokumentation erstellt keine Zugangsdaten und gewährt keinen Zugriff auf einen Shop.
Welche Anmeldeinformation gehört wohin?#
| Integration | Anmeldeinformation | Gehört hin |
|---|---|---|
| Shop-SDK | Shop ID und Publishable Key | Shop-SDK-Script-Attribute |
| Product Import API | Client ID und Client Secret | Ihr Backend oder ein sicherer serverseitiger Job |
Ein Publishable Key ist für den Browser bestimmt. Ein Client Secret muss auf Ihrem Server verbleiben. Fügen Sie sie niemals in ein Theme, öffentliches Markdown, Client-Bundle oder Support-Screenshot ein.
Anmeldeinformationen beschaffen und konfigurieren#
Öffnen Sie das Händler-Dashboard, wählen Sie den richtigen Shop aus und prüfen Sie SDK-Integration und Einstellungen. Folgen Sie den Onboarding-Anweisungen für Client ID und Client Secret.
Allowed Origins (CORS) konfigurieren#
Bevor Sie den SDK testen oder veröffentlichen, öffnen Sie Dashboard → Einstellungen für den richtigen Shop und suchen Sie Allowed Origins (CORS).
- Geben Sie die Origins der Shops ein, die den SDK laden, getrennt durch Kommas. Beispiel:
https://example.com, https://www.example.com, https://shop.example.com. - Verwenden Sie das Protokoll und den Hostnamen sowie den Port, sofern zutreffend, ohne Pfad, Query-String oder Fragment. Fügen Sie auch Ihren Preview- oder Staging-Origin hinzu, wenn Sie den SDK dort testen; verwenden Sie
http://localhost:3000nur, wenn dies Ihr tatsächlicher lokaler Test-Origin ist. - Klicken Sie auf Speichern, laden Sie den Shop neu und testen Sie den SDK erneut.
Prüfen Sie die tatsächliche URL, die Kunden besuchen: https://example.com und https://www.example.com sind unterschiedliche Origins. Ein erfolgreicher lokaler oder Vorschau-Test stellt nicht fest, dass der veröffentlichte Origin konfiguriert ist.
Beispielwerte ersetzen#
Beispiele verwenden Platzhalter wie <SHOP_ID>, <PUBLISHABLE_KEY> und <YOUR_CLIENT_SECRET>. Ersetzen Sie diese nur in der beabsichtigten Umgebung. HTML-Beispiele können spitze Klammern als < und > kodieren; ersetzen Sie den gesamten Platzhalter, einschließlich dieser Kodierung.
SDK und Produktimport-Umgebungen#
Der Browser lädt https://sdk.ideal.house/sdk.js mit der Shop ID und dem Publishable Key desselben Shops. Die Product Import API verwendet weiterhin https://sdkapi.ideal.house mit der dokumentierten serverseitigen Authentifizierung.
Konfigurieren Sie Ihre Preview- und Produktions-Shop-Origins getrennt wie oben beschrieben. Verwenden Sie vorbereitete Testprodukte vor der Veröffentlichung und schließen Sie dann die Launch-Checkliste ab.