Damit Wish API-Partner-Integratoren die Wish API-Dokumentationbesser verstehen, welche Aktionen über API im Vergleich zu Merchant Dashboard ausgeführt werden können und welche Funktionen beim Erstellen der Integration in Wish von entscheidend sind, haben wir den folgenden Leitfaden für API-Partner erstellt. Hier erfahren Sie, wie Sie eine öffentliche App über die API erstellen. Bitte befolgen Sie jeden Schritt:
1. Melden Sie sich für die öffentliche App in der Wish Sandbox-Umgebung an:
1). Partner registers as ERP via the ERP Signup page on Wish sandbox environment. Partner can review Wish API documentation.
2). Der Partner schickt eine E-Mail an Wishs Partner API E-Mail-Adresse (partner-api@wish.com), um Wish über die Anmeldung für den Partner-API-Zugriff auf die Wish-Sandbox-Umgebung zu informieren.
3). Wish genehmigt den Antrag des Partners.
4). Sobald der Partner zugelassen wurde, sollte er sich anmelden.
5). Klicken Sie auf Konto > App erstellen.
Erstellen Sie einen App-Namen (benutzen Sie einen Namen, den Händler sehen sollen). Die Umleitungs-URL wird für OAuth benötigt (an diese Adresse wird die Autorisierung gesendet. Sie können sie jederzeit ändern).
Bitte beachten Sie: Die Einzelheiten oben auf der Seite in Sandbox können Händler nicht sehen.
6). Partner will be provided with a client ID and client secret, which will be used by the Partner to do merchant account testing on Wish sandbox (Wish API OAuth process on sandbox requires client ID and client secret).
2. Der Partner erstellt als Händler ein zweites Login für die Sandbox. Da dies die Sandbox-Umgebung ist, müssen die vom Partner eingegebenen Händlerinformationen nicht die eines tatsächlichen Händlers sein.
1). Der Partner verwendet eine andere E-Mail-Adresse als bei der ERP-Registrierung, um sich bei Wish anzumelden und als Händler mit der Entwicklung öffentlicher Apps zu beginnen.
2). Verknüpfen Sie das gefälschte Händlerkonto mit dem ERP-Partner.
a). Wenn der Händler als Händler in der Sandbox angemeldet ist, sollte er die URL zu https://sandbox.merchant.wish.com/v3/oauth/authorize?client_id={client_id} ändern, wobei {client_id} die client_id ist, die der ERP wurde beim Erstellen der öffentlichen App generiert. Dies löst eine Aufforderung aus, den Händler aufzufordern, das ERP für den vollständigen Zugriff auf das Händlergeschäft zu autorisieren.
b). Wenn der Händler die Erlaubnis erteilt, ändert sich die URL zu https://example.redirect.uri.com?code={authorization_code} wobei die Umleitung angegeben wurde, als das ERP die öffentliche App erstellt hat.
c). An dieser Stelle können die typischen oAuth-Prozesse befolgt werden
d). Alle API-Anforderungen sollten das access_token enthalten. Zugriffstoken sind 30 Tage gültig.
e). Um neue Zugriffstoken zu erhalten, kann das refresh_token verwendet werden. Diese Aktion macht das vorherige Token ungültig.
3). Der Partner führt alle Tests in der Wish Sandbox-Umgebung durch.
4). Sie brauchen zum Fortsetzen keine zusätzliche Genehmigung von Wish
3. Melden Sie sich in der Wish Produktionsumgebung für die öffentliche App an
1). Partner registers as ERP in production via the ERP Signup page on Wish production environment.
2). Der Partner schickt eine E-Mail an Wishs Partner API E-Mail-Adresse (partner-api@wish.com), um Wish über die Anmeldung für den Partner-API-Zugriff auf die Wish-Sandbox-Umgebung zu informieren.
3). Wish genehmigt den Antrag des Partners oder benachrichtigt den Partner über erkannte Probleme.
4). Nach der Genehmigung können Sie sich anmelden und Konto > App erstellen auswählen.
Partner enters information to be published in the Wish App Store. App name and Redirect URL are required fields. Partner may also enter additional information, such as app logo, value proposition, description, website and/or support email, which need to undergo a review process as they will be visible to merchants.
If this additional information is entered, the app will still be created and be able to integrate with the API, however, these fields will only be published in the Wish App Store once they are approved. In the meantime, the approval status of these additional information fields can be viewed as shown below.
Sie können alle Informationen (Pflicht oder zusätzliche), die Sie oben eingegeben haben, ansehen und bearbeiten, indem Sie Konto > App-Einstellungen öffnen. Wenn Eingaben in den zusätzlichen Informationsfeldern bearbeitet oder gelöscht werden, werden sie erneut überprüft.
5). Lesen Sie die API-Dokumentation zur Produktionsumgebung von Wish
6). Partner schließt OAuth-Prozessab.
7). Partner müssen ihre Integration in die Wish-Produktionsumgebung aktivieren und darauf achten, dass API-Aufrufe auf die Wish-Produktionsumgebung und die Sandbox-Umgebung verweisen.
4. Händler müssen ein eindeutiges Geschäftskonto im Wish Merchant Dashboard registrieren und das ERP zum Senden / Empfangen von Daten zum / vom Wish Store des Händlers berechtigen.
1). Im Rahmen der Registrierung eines Händlerkontos müssen Händler Informationen einreichen, die die Geschäftslizenz und persönliche Daten bestätigen, die von Wish genehmigt werden.
2). Händlerkonten werden von einem Vertreter des Wish Account Managers genehmigt.
3). Merchants then need to authorize ERP through one of the following methods:
a). Merchant registers for an account at the ERP of their choice.
(i) Der Händler wählt den Wish-Autorisierungslink über die ERP-Schnittstelle aus und wird auf eine OAuth-Autorisierungsseite weitergeleitet, über die er das ERP autorisieren kann.
• Das Format des Links sollte wie folgt aussehen und die eindeutige Produktions-Client-ID des ERP enthalten: https://merchant.wish.com/v3/oauth/authorize?client_id={PRODUCTION_CLIENT_ID}}
(ii) Der Händler klickt auf „Autorisieren“ und wird mit einem Autorisierungscode zu der im ERP angegebenen „Umleitungs-URI“ weitergeleitet. ERP verwendet diesen Autorisierungscode verwenden, um Wish-APIs abzufragen und Zugriffstoken abzurufen.
b). Merchant discovers ERP on the Wish App Store (NOTE: this process is not yet launched, but ERPs should be able to handle this process in preparation for its future launch):
(i) Der Händler wählt „App hinzufügen“ aus und wird zu einer OAuth-Autorisierungsseite weitergeleitet, über die das ERP autorisiert werden kann.
(ii) Der Händler klickt auf „Autorisieren“ und wird mit einem Autorisierungscode zu der im ERP vorgegebenen „Umleitungs-URI“ weitergeleitet. Das ERP verwendet diesen Autorisierungscode, um Wish-APIs aufzurufen und Zugriffstoken abzurufen.
• Die Verbindung kann möglicherweise nicht abgeschlossen werden, falls die im ERP vorgegebene Seite „Umleitungs-URI“ den Fall nicht bearbeiten kann, da der Händler nicht angemeldet ist und/oder kein Konto im ERP hat.
• Bitten Sie den Händler, sich anzumelden oder sich bei Ihrem ERP-System zu registrieren, um eine Verbindung herzustellen. Fügen Sie dann den Autorisierungscode in die URL ein und schließen Sie den OAuth-Prozess ab, sobald der Händler sich angemeldet oder ein Konto erstellt hat.
c) Die Autorisierung ist jetzt abgeschlossen.
d) Wenn der Händler die Autorisierung des ERP zu einem bestimmten Zeitpunkt aufheben möchte, kann er dies über das Wish Händler-Dashboard unter „Konto” > „Einstellungen“ > „API-Einstellungen” tun.
Wir weisen darauf hin, dass Partner zur Verbesserung der Sicherheit ab sofort bis zu zwei OAuth-Client-Schlüssel zu ihren öffentlichen Apps hinzufügen können. Dazu brauchen Sie nur auf der Seite App-Einstellungen unter dem ersten Client-Schlüssel die Option „Zweiten Schlüssel hinzufügen“ anzuklicken:
Bei Bedarf können die beiden Schlüssel auch ausgewechselt werden, indem ein Schlüssel, dessen Sicherheit nicht mehr gewährleistet ist, gelöscht und stattdessen ein neuer hinzugefügt wird.
Note: For links to documentation, tips, tutorials, and more check out the Wish Developers Page.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.