Zugang zur Demo-Umgebung#

Diese Hilfeseite führt Sie durch das Erstellen einer eigenen App für den Mergado Store, deren Anbindung an die Mergado-API und das sichere Testen direkt in Mergado, ohne dass eine Zahlung nötig ist. Mergado ermöglicht Entwicklern, eigene Integrationen (“Apps”) zu erstellen, die die Funktionen des Editors erweitern oder mit dessen API kommunizieren. Eine offizielle „Demo-Umgebung" mit vorab hochgeladenen Daten gibt es nicht — stattdessen richten Sie sich in wenigen Schritten Ihr eigenes Testprojekt ein.

Schritt-für-Schritt-Anleitung#

1) Erstellen Sie ein Konto in Mergado#

Falls Sie noch kein Konto haben, erstellen Sie eines unter app.mergado.com.

2) Erstellen Sie Ihre eigene App#

Öffnen Sie: https://app.mergado.com/developers/create-app/
Füllen Sie die grundlegenden Angaben zur App aus.
Nach der Erstellung erhalten Sie Zugangsdaten (beziehungsweise Zugriff auf die Entitäten, für die die App aktiviert ist).

3) Bereiten Sie ein Testprojekt vor (sofern Ihre App auf Projektebene arbeitet)#

Legen Sie in Mergado ein neues Projekt für Tests an.
Laden Sie einen Testfeed hoch – ein kleiner Feed mit wenigen Produkten genügt.
Schalten Sie das Projekt in den Projekteinstellungen in den Testmodus, damit für das Testen nicht bezahlt werden muss.

4) Aktivieren Sie die App im Projekt#

Aktivieren (schalten Sie ein) Sie Ihre App in den Projekteinstellungen. Dadurch erhält sie Zugriff auf die Entitäten (Feeds/Projekte), die sie lesen und bearbeiten darf.

5) Autorisierung und API-Aufrufe#

Ablauf der Autorisierung: https://mergado.github.io/docs/api/authorization.html
API-Dokumentation: https://mergado.docs.apiary.io/#

Achten Sie auf die API-Version: Die verwendete Version beeinflusst das Verhalten der Endpunkte. Wenn die Version nicht übereinstimmt, kann sich das Verhalten von der Dokumentation unterscheiden.

Tipps für effektives Testen#

Es gibt keinen zentralen Demo-Shop – jeder Entwickler richtet sich ein eigenes Testprojekt ein.
Der Testmodus stellt sicher, dass für das Testen nichts bezahlt wird.
Wenn Ihre App Zugriff auf Projektebene benötigt, aktivieren Sie sie im jeweiligen Projekt.
Für schnelle Tests genügt ein kleiner Feed mit wenigen Produkten, es ist nicht nötig, Produktionsdaten hochzuladen.
Verwenden Sie ein separates Test-Konto/Projekt für Integrationen, damit Sie nicht in Produktionsdaten eingreifen.

FAQ#

Gibt es eine offizielle Demo-Umgebung mit Daten?#

Nein. Es stehen keine zentralen Demodaten zur Verfügung. Erstellen Sie sich Ihr eigenes Testprojekt in Mergado.

Wo erstelle ich ein Konto in Mergado?#

Unter app.mergado.com.

Wo erstelle ich meine App?#

Unter https://app.mergado.com/developers/create-app/. Nach dem Ausfüllen der Grunddaten erhalten Sie Zugriff auf die Entitäten, für die die App aktiviert ist.

Wie teste ich ohne Kosten?#

Aktivieren Sie in den Projekteinstellungen den Testmodus.

Benötige ich ein Projekt, wenn meine App mit Projekten arbeitet?#

Ja. Legen Sie ein Testprojekt an, laden Sie einen kleinen Feed hoch und aktivieren Sie die App im Projekt.

Wie gewähre ich meiner App Zugriff auf die Projektdaten?#

Aktivieren Sie die App in den Projekteinstellungen. Sie erhält dadurch Zugriff auf die Feeds/Projekte, die sie lesen/bearbeiten darf.

Wo finde ich den Ablauf der Autorisierung gegenüber der API?#

In der Dokumentation: https://mergado.github.io/docs/api/authorization.html.

Wo ist die vollständige API-Dokumentation?#

Unter https://mergado.docs.apiary.io/#.

Ein Endpunkt verhält sich anders als in der Dokumentation. Was soll ich tun?#

Überprüfen Sie die API-Version. Das Verhalten der Endpunkte ist versioniert, und eine abweichende Version kann zu anderem Verhalten führen.

Wie groß sollte der Feed für Tests sein?#

Ein kleiner Feed mit wenigen Produkten genügt – er eignet sich ideal für schnelle Iterationen.

Wie schütze ich Produktionsdaten während der Entwicklung?#

Verwenden Sie ein separates Test-Konto/Projekt, damit die Änderungen die Produktion nicht betreffen.