Allgemeine Aktionen:
Anmelden
Wiki
▼
:
Dokumentenindex
»
Space:
REST-Api
▼
:
Dokumentenverzeichnis
»
Seite:
WebHome
Suche
Aktionen:
Exportieren
▼
:
Als PDF exportieren
Als RTF exportieren
Als HTML exportieren
Weitere Aktionen
▼
:
Druckvorschau
Zeige den Quellcode
VIA-Connect - REST API
Wiki-Quellcode von
VIA-Connect - REST API
Zuletzt geändert von
Thomas Hoffmann
am 2017/11/21 15:18
Inhalt
·
Kommentare
(0)
·
Anhänge
(0)
·
Historie
Zeilennummern verstecken
1: {{box cssClass="floatinginfobox" title="**Inhalt**"}} 2: {{toc start="1"/}} 3: {{/box}} 4: 5: {{warning}} 6: \\Die aktuelle Version der VIA-Connect REST API befindet sich in einer **Testumgebung**. 7: Es kann noch zu Änderungen an der Service-URL und an den EntitySets kommen. 8: \\ 9: {{/warning}} 10: 11: = Allgemeine Information = 12: 13: Mit der VIA API können Produktdaten aus einem Fremdsystem automatisiert als Angebote bei eBay platziert werden, ohne in dem Fremdsystem die eBay API implementieren zu müssen. 14: 15: Die eBay Verkaufsdaten werden zur Verfügung gestellt, damit die Prozesse nach einem Verkauf in dem Fremdsystem weiterhin gesteuert werden können. 16: 17: Die API bietet die Möglichkeit Produkt- und Katalogdaten von einem Fremdsystem bei VIA zu speichern, zu aktualisieren und bei Bedarf auch zu löschen. 18: 19: 20: == Zugangsdaten für Testumgebung anfordern == 21: 22: {{info}} 23: 24: Die Testumgebung der VIA API kommuniziert ausschliesslich mit der **eBay Sandox ([[http:~~/~~/cgi.sandbox.ebay.com>>url:http://cgi.sandbox.ebay.com||rel="__blank"]])**.\\ 25: Für die Nutzung der VIA API benötigen Sie daher einen eBay-Sandbox Entwickler Konto sowie einen eBay-Sandbox Verkäufer-Testuser und Käufer-Testuser.\\ 26: 27: {{/info}} 28: 29: 30: === eBay-Sandbox Anmeldeprozess === 31: 32: 1. Erstellen Sie sich bitte unter nachfolgendem Link einen eigenen eBay Entwickler Account: [[https:~~/~~/developer.ebay.com/join>>url:https://developer.ebay.com/join||rel="__blank"]] 33: 1. Loggen Sie sich in Ihren neu erstellten Entwickler Account ein und rufen folgenden Link auf: [[https:~~/~~/developer.ebay.com/DevZone/sandboxuser/>>url:https://developer.ebay.com/DevZone/sandboxuser/||rel="__blank"]]\\ 34: 1. Erstellen Sie sich bitte einen Verkäufer-Testuser (z.B. „Testuser_IhreFirmaSeller) und Käufer-Testuser (z.B. Testuser_IhreFirmaBuyer).\\ 35: 1. Senden Sie uns bitte Ihre Kontaktdaten und die Logindaten Ihres eBay Verkäufer-Testuser (Name und Passwort) mit Betreff „Anfrage Zugangsdaten“ an folgende Mailadresse: (% style="mso-fareast-font-family:Calibri" %)[[entwickler@via.de>>mailto:entwickler@via.de]] 36: 37: Innerhalb von 24 Stunden erhalten Sie von uns die erforderlichen Daten um einen End-to-End Test zwischen dem VIA-Connect System und der eBay Sandbox durchzuführen. 38: 39: === eBay Verkäufer-Testuser mit Paypal-Sandbox Account verknüpfen === 40: 41: Damit Sie bei Ihren Testkäufen auch eine Paypal-Zahlung durchführen können, müssen Sie Ihr eBay-Sandbox Verkäufer-Testuser mit unserem Paypal-Sandbox Account verknüpfen. 42: 43: 1. Rufen Sie folgenden Link auf: https://signin.sandbox.ebay.com/ws/eBayISAPI.dll?SignIn 44: 1. Loggen Sie sich mit Ihrem eBay Verkäufer-Testuser ein 45: 1. Rufen Sie in einer neuen Registerkarte folgenden Link auf: [[https:~~/~~/www.sandbox.paypal.com/de/cgi-bin/webscr?cmd=_login-run>>url:https://www.sandbox.paypal.com/de/cgi-bin/webscr?cmd=_login-run||rel="__blank"]] 46: 1. Geben Sie folgenden Login Daten an: 47: Email: //seller_1347281503_biz@via-ebay.de// 48: Passwort: //test12345// 49: 1. Rufen Sie nach dem Login folgenden Link auf: [[http:~~/~~/my.sandbox.ebay.com/ws/eBayISAPI.dll?MyeBay&CurrentPage=MyeBayPayPalAccounts&gbh=1&ssPageName=STRK:ME:LNLK>>url:http://my.sandbox.ebay.com/ws/eBayISAPI.dll?MyeBay&CurrentPage=MyeBayPayPalAccounts&gbh=1&ssPageName=STRK:ME:LNLK||rel="__blank"]] 50: 1. Klicken Sie auf den rechten Button "//Link My PayPal Account"// 51: 1. Geben Sie folgenden Login Daten an: 52: Email: //seller_1347281503_biz@via-ebay.de// 53: Passwort: //test12345 54: // 55: 1. Klicken Sie jetzt auf den Button //"Return To eBay"// 56: 57: === Bezahlung mit PayPal-Sandbox Käufer Daten === 58: 59: Damit Sie die fiktive PayPal Zahlung durchführen können, melden Sie sich innerhalb der eBay Kaufabwicklung mit folgenden PayPal Daten als Käufer an: 60: eMail: //buyer_1347281394_per@via-ebay.de// 61: Passwort: //test12345// 62: 63: = Technische Details = 64: 65: Die API basiert auf der [[REST>>http://de.wikipedia.org/wiki/Representational_State_Transfer||rel="__blank"]] Technologie. 66: 67: Die Daten können mittels des [[OData>>http://www.odata.org/documentation/IndexV2||rel="__blank"]] Protokolls mit der unterstützten Version 2 abgerufen und aktualisiert werden. 68: 69: Die API unterstützt [[XML>>url:http://de.wikipedia.org/wiki/XML||rel="__blank"]] (Standard Request/Response Format) und das [[JSON>>url:http://de.wikipedia.org/wiki/JSON||rel="__blank"]] Format. 70: 71: = Authentifizierung URL = 72: 73: {{info}} 74: Nutzen Sie während der Entwicklung der Anbindung des Fremdsystems nur die Sandbox Url. 75: Die Live Url soll nur für den Produktiveinsatz genutzt werden. 76: {{/info}} 77: 78: == Sandbox URL == 79: 80: Der Service für die Authentifizierung für die VIA-Connect Sandbox Umgebung wird unter der folgenden URL aufgerufen: [[http:~~/~~/sandboxapi.via.de/Authentication_JSON_AppService.axd/Login>>http://sandboxapi.via.de/Authentication_JSON_AppService.axd/Login||rel="__blank" title="Auth-URL"]] 81: 82: == Live URL == 83: 84: Der Service für die Authentifizierung für die VIA-Connect Live Umgebung wird unter der folgenden URL aufgerufen: [[http:~~/~~/ebayapi.via.de/Authentication_JSON_AppService.axd/Login>>url:http://ebayapi.via.de/Authentication_JSON_AppService.axd/Login||rel="__blank"]] 85: 86: = Service URL = 87: 88: {{info}} 89: Nutzen Sie während der Entwicklung der Anbindung des Fremdsystems nur die Sandbox Url. 90: Die Live Url soll nur für den Produktiveinsatz genutzt werden. 91: {{/info}} 92: 93: == Sandbox URL == 94: 95: Der Service der API für die VIA-Connect Sandbox Umgebung wird unter der folgenden URL aufgerufen: [[http:~~/~~/sandboxapi.via.de/publicapi/v1/api.svc/>>http://sandboxapi.via.de/publicapi/v1/api.svc/||rel="__blank" title="Service-URL"]] 96: 97: == Live URL == 98: 99: Der Service der API für die VIA-Connect Live Umgebung wird unter der folgenden URL aufgerufen: [[http:~~/~~/ebayapi.via.de/publicapi/v1/api.svc/>>url:http://ebayapi.via.de/publicapi/v1/api.svc/||rel="__blank"]] 100: 101: 102: = Metadaten URL = 103: 104: Die Metadaten des Services können unter folgender URL abgerufen werden: [[http:~~/~~/sandboxapi.via.de/publicapi/v1/metadata.xml>>http://sandboxapi.via.de/publicapi/v1/metadata.xml||rel="__blank" title="Service Metadaten URL"]] 105: 106: {{info}} 107: Hier werden alle EntitySets und deren Properties sowie die Navigation Properties aufgeführt. 108: {{/info}} 109: 110: = Externe Test-Tools = 111: 112: Mit folgenden externen Tools kann man die API von VIA für einfache Tests ansprechen: 113: - [[RESTClient>>https://addons.mozilla.org/de/firefox/addon/restclient/||rel="__blank"]] (Firefox Add-On) 114: 115: 116: {{putFootnotes/}}
Dokumentation
Allgemeine Informationen
Session + Authentifizierung
Status-Codes
EntitySets
Catalogs
Beispiele
Products
Beispiele
ProductImages
Beispiele
ProductRelations
Beispiele
ProductSpecifics
Beispiele
ProductVariations
Beispiele
ProductVariationSpecifics
Beispiele
ProductVariationImages
Beispiele
OptionalProductAttributes
Beispiele
SalesOrders
Beispiele
SalesOrderItems
Beispiele
Addresses
Buyers
Listings
ListingItems
DiscountOffers
Beispiele
CarParts
Beispiele
ServiceOperations
GetSalesOrderHistory
ProductIsListed
SetEbayCategory
DeleteAccountData
SetProductProfile
SetCatalogProfile
ReviseInventoryStatus
FAQ
Letzte Änderungen