Was ist die OTTO Market API für Händler?

Was über die Schnittstelle geht

Die OTTO Market API ist in Bereiche geteilt, OTTO nennt sie Scopes. Eine App bekommt nur die Bereiche, die du freigibst.

Nicht über die Schnittstelle kommen deine Rechnungen von OTTO, deine Auszahlungen und die Zahlen von Sponsored Display Ads. Die stehen nur im Partnerportal.

Zwei Wege an dein Konto: eigener Zugang oder App eines Anbieters

Ein eigener Zugang ist für Händler, die selbst programmieren. Wer in der Nutzerverwaltung das Recht „API-Zugriff“ hat, legt im Partnerportal eine eigene App an und wählt ihre Bereiche. Das Kennwort dieser App zeigt OTTO nur einmal an.

Eine App eines Anbieters ist der übliche Weg. OTTO nennt solche Anbieter Servicepartner. Ihre App ist entweder privat, dann bekommst du einen Einladungslink, der 24 Stunden gilt und nur einmal funktioniert. Oder sie ist öffentlich, dann gilt ihr Link für alle. Öffentlich wird eine App erst, wenn OTTO sie je Bereich geprüft hat.

So läuft die Freigabe einer App

Dafür braucht dein Nutzer in der Nutzerverwaltung das Recht für Servicepartner.

1. Du öffnest den Link des Anbieters.
2. Du meldest dich bei OTTO an, auf der Seite von OTTO, mit deinem eigenen Login.
3. OTTO zeigt dir die Bereiche, die die App verlangt. Du stimmst allen zu oder brichst ab, einen Teil freigeben geht nicht.
4. Die App steht danach in deinen Einstellungen unter „Servicepartner“ bei den installierten Apps.

Will ein Anbieter später mehr Bereiche, braucht er eine neue Fassung seiner App. OTTO schreibt dir dann eine Mail und zeigt einen Hinweis im Portal. Ob du die neue Fassung installierst, entscheidest du.

Worauf du vor der Freigabe achtest

• Passwort nur bei OTTO: Eine App, die dich nach deinem OTTO-Passwort fragt, nutzt nicht diesen Weg. Über die Schnittstelle gibst du dein Passwort nur auf der Seite von OTTO ein.
• Bereiche passend zur Aufgabe: Ein Werkzeug für Werbung braucht den Bereich für Sponsored Product Ads, ein Versandprogramm Orders und Shipments. Verlangt eine App mehr, als ihre Aufgabe braucht, frag nach.
• Alles oder nichts: Weil du nur alle Bereiche einer App freigeben kannst, entscheidest du dich für die ganze App.
• Lesen und ändern: Die meisten Bereiche erlauben beides zugleich, getrennt freigeben kannst du das nicht. Frag den Anbieter, wann seine App etwas ändert und ob du es vorher siehst.

So entziehst du einer App den Zugriff

In OTTO Partner Connect öffnest du über das Zahnrad die Einstellungen und dort „Servicepartner“. Bei den installierten Apps fährst du mit der Maus über den Namen der App, klickst auf „Zugriff entziehen“ und bestätigst. Danach kommt die App nicht mehr an deine Daten. Du kannst sie später wieder installieren.

Wer einen eigenen Zugang angelegt hat, prüft dazu regelmäßig, welche Nutzer das Recht „API-Zugriff“ haben. Laut OTTO laufen Zugangsdaten nach 180 Tagen ab, wenn für sie keine festen Adressen hinterlegt sind, von denen aus Programme anfragen dürfen.

Rechenbeispiel: Wie viele Abfragen eine App am Tag stellen darf

Angenommen, du hast 1.000 Artikel, und dein Programm gleicht den Bestand jede Stunde mit OTTO ab. OTTO nimmt beim Bestand bis zu 200 Artikel je Anfrage und 10 Anfragen je Sekunde.

Fragt ein Programm jeden Artikel einzeln ab, sind es 1.000 Anfragen und 100 Sekunden je Abgleich. Frag deshalb einen Anbieter, wie aktuell dein Bestand bei OTTO ist, wenn du viele Artikel hast.