FAQ:DieeBayAPIWozubraucheichdieAPIundwasistdas: Unterschied zwischen den Versionen

Aus Afterbuy-Wiki
Wechseln zu:Navigation, Suche
K
 
(5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 3: Zeile 3:
 
'''Was ist die API?'''
 
'''Was ist die API?'''
  
Die API, oder auch Schnittstelle zu eBay, ist ein Direktzugriff auf die eBay-Daten.
+
Die API oder auch Schnittstelle zu eBay ist ein Direktzugriff auf die eBay-Daten.
Mit der Schnittstelle steht Ihnen auch die Ebay-History zur Verfügung, eine Übersicht Ihrer letzten eBay-Artikel.
+
Mit der Schnittstelle steht Ihnen auch die eBay-History zur Verfügung, eine Übersicht Ihrer letzten eBay-Artikel.
 
Afterbuy fragt die Daten in regelmäßigen Abständen bei eBay ab. Das Intervall können Sie selbst festlegen. Es liegt zwischen 2 und 8 Stunden.
 
Afterbuy fragt die Daten in regelmäßigen Abständen bei eBay ab. Das Intervall können Sie selbst festlegen. Es liegt zwischen 2 und 8 Stunden.
 
Artikel, die Sie mit Afterbuy eingestellt oder gelistet haben, werden in der Regel sofort nach Transaktionsende importiert. Artikel, die Sie mit anderen Programmen oder bei eBay direkt eingestellt haben, werden in den angegebenen Intervallen importiert.
 
Artikel, die Sie mit Afterbuy eingestellt oder gelistet haben, werden in der Regel sofort nach Transaktionsende importiert. Artikel, die Sie mit anderen Programmen oder bei eBay direkt eingestellt haben, werden in den angegebenen Intervallen importiert.
Ausnahme sind normale Auktionen. Aufgrund eines eBay-Fehlers kann es vorkommen, dass diese auch dann, wenn Sie mit Afterbuy eingestellt oder relistet wurden, nicht sofort vollständig importiert. Sie werden zwar angelegt, die Kundendaten bestehen, aber zunächst nur aus eBayName und Mailadresse. Die restlichen
+
Ausnahme sind normale Auktionen. Aufgrund eines eBay-Fehlers kann es vorkommen, dass diese auch dann, wenn sie mit Afterbuy eingestellt oder relistet wurden, nicht sofort vollständig importiert werden. Sie werden zwar angelegt, die Kundendaten bestehen aber zunächst nur aus eBayName und E-Mail-Adresse. Die restlichen
 
Daten werden dann bei den normalen Abfrage-Intervallen nachgeliefert.
 
Daten werden dann bei den normalen Abfrage-Intervallen nachgeliefert.
  
'''Was ist der nutzen der API'''
+
'''Was ist der Nutzen der API'''
  
# Aktuelle übernahme ihrer Daten
+
# Aktuelle Übernahme Ihrer Daten
 
# eBay-History mit Ansicht aller ausgelaufenen Auktionen
 
# eBay-History mit Ansicht aller ausgelaufenen Auktionen
 
# Bestandskontrolliertes Listen
 
# Bestandskontrolliertes Listen
 
# Ermitteln der Versandkosten
 
# Ermitteln der Versandkosten
# Auktionstitel durch Produnktnamen ersetzen
+
# Auktionstitel durch Produktnamen ersetzen
 
# Automatisches Bewerten
 
# Automatisches Bewerten
 
# Durch die API werden die Bewertungen des Käufers in der Auktionsübersicht angezeigt
 
# Durch die API werden die Bewertungen des Käufers in der Auktionsübersicht angezeigt
Zeile 25: Zeile 25:
  
 
# Bei der Nutzung der Schnittstelle kommen alle Daten nach dem Verkauf automatisch zu Afterbuy.
 
# Bei der Nutzung der Schnittstelle kommen alle Daten nach dem Verkauf automatisch zu Afterbuy.
# Ebayhistory mit Ansicht aller ausgelaufenen Auktionen zur Analyse, direktes relisten oder Stammartikelanlage.
+
# Ebay-History mit Ansicht aller ausgelaufenen Auktionen zur Analyse, direktes Relisten oder Stammartikelanlage.
# Durch die API kann beim listen eine interne ID mit nach Ebay geschickt werden die zur Stammartikelerkennung dient. Die Anlage eines Stammartikels mit Mengenangabe ist für das bestands- und zeitgesteuertes Listen in Ebay.
+
# Durch die API kann beim Listen eine interne ID mit nach Ebay geschickt werden, die zur Stammartikelerkennung dient. Die Anlage eines Stammartikels mit Mengenangabe ist für bestands- und zeitgesteuerte Listen in Ebay erforderlich.
# Durch die API und dem Bestandsartikel können die Versandkosten genau zugewiesen und ermittelt werden.
+
# Durch die API und den Bestandsartikel können die Versandkosten genau zugewiesen und ermittelt werden.
# Durch die API und dem Bestandsartikel ist es möglich den Auktionstitel durch den Namen des Stammartikels ersetzen zu lassen.
+
# Durch die API und den Bestandsartikel ist es möglich, den Auktionstitel durch den Namen des Stammartikels ersetzen zu lassen.
# Durch die API werden die Bewertungen vom Käufer automatisch eingetragen und auf Wunsch auch zurück bewertet.
+
# Durch die API werden die Bewertungen vom Käufer automatisch eingetragen und auf Wunsch auch zurück-bewertet.
# Durch die API werden die Menge an Bewertungen in der Auktionsübersicht angezeigt.
+
# Durch die API werden die Anzahlen an Bewertungen in der Auktionsübersicht angezeigt.
 +
 
  
 
'''Wie bekomme ich die API'''
 
'''Wie bekomme ich die API'''
  
Die API kann vom Management Center unter  
+
Die API kann im Management Center unter  
 
{{Breadcrumb|"Einstellungen/Tarif & Rechnung/Tarifwahl}}
 
{{Breadcrumb|"Einstellungen/Tarif & Rechnung/Tarifwahl}}
als direkter Ebayzugriff ausgewählt werden.
+
als direkter eBay-Zugriff ausgewählt werden.
 
Bitte bestätigen Sie den neuen Tarif durch das Zurücksenden der Tarifbestätigung.
 
Bitte bestätigen Sie den neuen Tarif durch das Zurücksenden der Tarifbestätigung.
  
 
'''Die API funktioniert nicht - es kommen keine Daten an.'''
 
'''Die API funktioniert nicht - es kommen keine Daten an.'''
  
Wenn sie die API auswählen muß diese manuell aktiviert werden.
+
Wenn Sie die API auswählen, muss diese manuell aktiviert werden.
Dieses kann einen Tag dauern und geschieht nur bei einer Mailbestätigung des Tarifes.
+
Dies kann einen Tag dauern und geschieht nur bei einer Mailbestätigung des Tarifs.
Die API muß dann unter "Marktplätze"> "eBay" > "eBay Einstellungen" >"eBaydaten-Zugriff" eingeschaltet werden.
+
Die API muss dann unter "Marktplätze"> "eBay" > "eBay Einstellungen" >"eBaydaten-Zugriff" eingeschaltet werden.
Es muß ein Token (Digitalisierung und Verschlüsselung von eBayName und Passwort) bei eBay geholt werden.
+
Es muss ein Token (Digitalisierung und Verschlüsselung von eBayName und Passwort) bei eBay geholt werden.
  
'''Möglichkeiten warum die API nicht mehr funktioniert.'''
+
'''Möglichkeiten, warum die API nicht mehr funktioniert.'''
  
 
# Ihr Account wurde gesperrt: Nach Freischaltung des Accounts bitte unter "Marktplätze"> "eBay" > "eBay Einstellungen" >"eBaydaten-Zugriff" die API wieder einschalten.
 
# Ihr Account wurde gesperrt: Nach Freischaltung des Accounts bitte unter "Marktplätze"> "eBay" > "eBay Einstellungen" >"eBaydaten-Zugriff" die API wieder einschalten.
 
# Bei eBay wurden Änderungen am Namen oder Passwort gemacht: Bitte dann unbedingt einen neuen Token holen.
 
# Bei eBay wurden Änderungen am Namen oder Passwort gemacht: Bitte dann unbedingt einen neuen Token holen.
# Sie haben sich beim Wechsel von einem Account zum Anderen nicht ausgelogt.
+
# Sie haben sich beim Wechsel von einem Account zum anderen nicht ausgeloggt.
 +
 
  
'''Bitte beachten Sie die folgenden Regeln, bevor Sie die API- Nutzung Aktivieren:'''
+
'''Bitte beachten Sie die folgenden Regeln, bevor Sie die API-Nutzung aktivieren:'''
  
Die API Nutzung im 8 Stundenintervall ist in den Tarifen "Seller" und "PowerSeller" in den Grundgebühren erhalten.
+
Die API-Nutzung im 8-Stundenintervall ist in den Tarifen "Seller" und "PowerSeller" in den Grundgebühren erhalten.
 
Die Kosten für kürzere Intervalle gliedern sich wie folgt:
 
Die Kosten für kürzere Intervalle gliedern sich wie folgt:
  
Zeile 67: Zeile 69:
  
 
Für die alten Tarife gelten folgende Angaben:
 
Für die alten Tarife gelten folgende Angaben:
Kosten für Abfrage-Intervall:
+
Kosten für das Abfrage-Intervall:
  
 
12 Stunden: 3,50 Euro/Monat
 
12 Stunden: 3,50 Euro/Monat
Zeile 78: Zeile 80:
 
Die Intervalle können einmal im Monat zum 1. des Folgemonats per Tarifwechsel geändert werden. Die Beiträge werden im Voraus fällig.
 
Die Intervalle können einmal im Monat zum 1. des Folgemonats per Tarifwechsel geändert werden. Die Beiträge werden im Voraus fällig.
  
Deaktivieren der API- Abfragen in den Stammdaten wirkt sich nicht auf die Abrechnung aus. Dazu ist ein Abwählen der Funktion per Tarifwahl nötig!
+
Das Deaktivieren der API-Abfragen in den Stammdaten wirkt sich nicht auf die Abrechnung aus. Dazu ist ein Abwählen der Funktion per Tarifwahl nötig!
 
Um die API endgültig einzuschalten, müssen Sie nach der Freigabe den Aktivierungshaken unter "Stammdaten" setzen und speichern!
 
Um die API endgültig einzuschalten, müssen Sie nach der Freigabe den Aktivierungshaken unter "Stammdaten" setzen und speichern!
  
 
'''API und das Token-System'''
 
'''API und das Token-System'''
  
Wir benötigen das Token für alle Zugriffe auf die eBaydaten, insbesondere für die API-Funktionen sowie für das Bewerten, Listen und das Versenden von eBay-Zahlungsaufforderungen.
+
Wir benötigen das Token für alle Zugriffe auf die eBay-Daten, insbesondere für die API-Funktionen sowie für das Bewerten, Listen und das Versenden von eBay-Zahlungsaufforderungen.
Das Token wird bei eBay, für die VIA-Online GmbH, dem Betreiber von Afterbuy ausgestellt.
+
Das Token wird bei eBay für die VIA-Online GmbH, dem Betreiber von Afterbuy, ausgestellt.
  
 
'''Weitere Informationen zum Tokenverfahren'''
 
'''Weitere Informationen zum Tokenverfahren'''
Zeile 90: Zeile 92:
 
'''Was ist "Auth & Auth"?'''
 
'''Was ist "Auth & Auth"?'''
  
Auth & Auth ist der Mechanismus, mit dem eBay-Mitglieder Drittanbieter-Applikationen autorisieren, so dass Applikationen diese eBay-Mitglieder gegenüber dem API authentifizieren können, ohne dabei persönliche Passwort-Informationen preiszugeben.
+
Auth & Auth ist der Mechanismus, mit dem eBay-Mitglieder Drittanbieter-Applikationen autorisieren können, so dass Applikationen diese eBay-Mitglieder gegenüber der API authentifizieren können, ohne dabei persönliche Passwort-Informationen preiszugeben.
 
Die neue Authentifizierungs- und Autorisierungs-Funktion macht die Mitglieder-Authentifizierung in Datenbankabfragen zur eBay-API sicherer, was sowohl dem Entwickler als auch dem Kunden
 
Die neue Authentifizierungs- und Autorisierungs-Funktion macht die Mitglieder-Authentifizierung in Datenbankabfragen zur eBay-API sicherer, was sowohl dem Entwickler als auch dem Kunden
 
zugute kommt. Weitere Vorteile sind:
 
zugute kommt. Weitere Vorteile sind:
Zeile 97: Zeile 99:
 
Die Applikationen brauchen keine Passwörter mehr zu speichern.
 
Die Applikationen brauchen keine Passwörter mehr zu speichern.
  
{{Warnung|Achten Sie darauf, dass sie nur ein Browser-Fenster geöffnet haben, sich dort mit dem Account: '''Ihren Account''' Account.
+
{{Warnung|Achten Sie darauf, dass Sie nur ein Browser-Fenster geöffnet haben und dort mit '''Ihrem eigenen Account''' angemeldet sind.
Sollten Sie sich unter einem anderen Namen anmelden, führt Afterbuy alle eBay-Abfragen für diesen eBay-Namen aus, und nicht für '''Ihren''' Account}}
+
Sollten Sie sich unter einem anderen Namen anmelden, führt Afterbuy alle eBay-Abfragen für diesen eBay-Namen aus und nicht für Ihren Account.}}

Aktuelle Version vom 12. April 2023, 14:37 Uhr

Die eBay-API - Wozu brauche ich die API und was ist das?

Was ist die API?

Die API oder auch Schnittstelle zu eBay ist ein Direktzugriff auf die eBay-Daten. Mit der Schnittstelle steht Ihnen auch die eBay-History zur Verfügung, eine Übersicht Ihrer letzten eBay-Artikel. Afterbuy fragt die Daten in regelmäßigen Abständen bei eBay ab. Das Intervall können Sie selbst festlegen. Es liegt zwischen 2 und 8 Stunden. Artikel, die Sie mit Afterbuy eingestellt oder gelistet haben, werden in der Regel sofort nach Transaktionsende importiert. Artikel, die Sie mit anderen Programmen oder bei eBay direkt eingestellt haben, werden in den angegebenen Intervallen importiert. Ausnahme sind normale Auktionen. Aufgrund eines eBay-Fehlers kann es vorkommen, dass diese auch dann, wenn sie mit Afterbuy eingestellt oder relistet wurden, nicht sofort vollständig importiert werden. Sie werden zwar angelegt, die Kundendaten bestehen aber zunächst nur aus eBayName und E-Mail-Adresse. Die restlichen Daten werden dann bei den normalen Abfrage-Intervallen nachgeliefert.

Was ist der Nutzen der API

  1. Aktuelle Übernahme Ihrer Daten
  2. eBay-History mit Ansicht aller ausgelaufenen Auktionen
  3. Bestandskontrolliertes Listen
  4. Ermitteln der Versandkosten
  5. Auktionstitel durch Produktnamen ersetzen
  6. Automatisches Bewerten
  7. Durch die API werden die Bewertungen des Käufers in der Auktionsübersicht angezeigt
  8. eBay Mahnung/Gutschrift kann über Afterbuy ausgelöst werden


Noch etwas genauer erklärt

  1. Bei der Nutzung der Schnittstelle kommen alle Daten nach dem Verkauf automatisch zu Afterbuy.
  2. Ebay-History mit Ansicht aller ausgelaufenen Auktionen zur Analyse, direktes Relisten oder Stammartikelanlage.
  3. Durch die API kann beim Listen eine interne ID mit nach Ebay geschickt werden, die zur Stammartikelerkennung dient. Die Anlage eines Stammartikels mit Mengenangabe ist für bestands- und zeitgesteuerte Listen in Ebay erforderlich.
  4. Durch die API und den Bestandsartikel können die Versandkosten genau zugewiesen und ermittelt werden.
  5. Durch die API und den Bestandsartikel ist es möglich, den Auktionstitel durch den Namen des Stammartikels ersetzen zu lassen.
  6. Durch die API werden die Bewertungen vom Käufer automatisch eingetragen und auf Wunsch auch zurück-bewertet.
  7. Durch die API werden die Anzahlen an Bewertungen in der Auktionsübersicht angezeigt.


Wie bekomme ich die API

Die API kann im Management Center unter

  Einstellungen      Tarif & Rechnung      Tarifwahl

als direkter eBay-Zugriff ausgewählt werden. Bitte bestätigen Sie den neuen Tarif durch das Zurücksenden der Tarifbestätigung.

Die API funktioniert nicht - es kommen keine Daten an.

Wenn Sie die API auswählen, muss diese manuell aktiviert werden. Dies kann einen Tag dauern und geschieht nur bei einer Mailbestätigung des Tarifs. Die API muss dann unter "Marktplätze"> "eBay" > "eBay Einstellungen" >"eBaydaten-Zugriff" eingeschaltet werden. Es muss ein Token (Digitalisierung und Verschlüsselung von eBayName und Passwort) bei eBay geholt werden.

Möglichkeiten, warum die API nicht mehr funktioniert.

  1. Ihr Account wurde gesperrt: Nach Freischaltung des Accounts bitte unter "Marktplätze"> "eBay" > "eBay Einstellungen" >"eBaydaten-Zugriff" die API wieder einschalten.
  2. Bei eBay wurden Änderungen am Namen oder Passwort gemacht: Bitte dann unbedingt einen neuen Token holen.
  3. Sie haben sich beim Wechsel von einem Account zum anderen nicht ausgeloggt.


Bitte beachten Sie die folgenden Regeln, bevor Sie die API-Nutzung aktivieren:

Die API-Nutzung im 8-Stundenintervall ist in den Tarifen "Seller" und "PowerSeller" in den Grundgebühren erhalten. Die Kosten für kürzere Intervalle gliedern sich wie folgt:

4 Stunden: 2,00 Euro/Monat 2 Stunden: 4,00 Euro/Monat

Manuelles Abfragen 12 Stunden rückwirkend 0,06 EUR / je Abfrage (immer möglich) Manuelles Abfragen 24 Stunden rückwirkend 0,10 EUR / je Abfrage (immer möglich) Manuelles Abfragen 48 Stunden rückwirkend 0,20 EUR / je Abfrage (immer möglich) Manuelles Abfragen 72 Stunden rückwirkend 0,30 EUR / je Abfrage (immer möglich)


Für die alten Tarife gelten folgende Angaben: Kosten für das Abfrage-Intervall:

12 Stunden: 3,50 Euro/Monat 8 Stunden: 6,00 Euro/Monat 4 Stunden: 8,00 Euro/Monat 2 Stunden: 10,00 Euro/Monat

Manuelle Abfragen analog zu den neuen Tarifen.

Die Intervalle können einmal im Monat zum 1. des Folgemonats per Tarifwechsel geändert werden. Die Beiträge werden im Voraus fällig.

Das Deaktivieren der API-Abfragen in den Stammdaten wirkt sich nicht auf die Abrechnung aus. Dazu ist ein Abwählen der Funktion per Tarifwahl nötig! Um die API endgültig einzuschalten, müssen Sie nach der Freigabe den Aktivierungshaken unter "Stammdaten" setzen und speichern!

API und das Token-System

Wir benötigen das Token für alle Zugriffe auf die eBay-Daten, insbesondere für die API-Funktionen sowie für das Bewerten, Listen und das Versenden von eBay-Zahlungsaufforderungen. Das Token wird bei eBay für die VIA-Online GmbH, dem Betreiber von Afterbuy, ausgestellt.

Weitere Informationen zum Tokenverfahren

Was ist "Auth & Auth"?

Auth & Auth ist der Mechanismus, mit dem eBay-Mitglieder Drittanbieter-Applikationen autorisieren können, so dass Applikationen diese eBay-Mitglieder gegenüber der API authentifizieren können, ohne dabei persönliche Passwort-Informationen preiszugeben. Die neue Authentifizierungs- und Autorisierungs-Funktion macht die Mitglieder-Authentifizierung in Datenbankabfragen zur eBay-API sicherer, was sowohl dem Entwickler als auch dem Kunden zugute kommt. Weitere Vorteile sind:

Nutzer einer Applikation authentifizieren sich selbst auf der vertrauten eBay-Einlogseite. Die Applikationen brauchen keine Passwörter mehr zu speichern.

Achten Sie darauf, dass Sie nur ein Browser-Fenster geöffnet haben und dort mit Ihrem eigenen Account angemeldet sind. Sollten Sie sich unter einem anderen Namen anmelden, führt Afterbuy alle eBay-Abfragen für diesen eBay-Namen aus und nicht für Ihren Account.