Das ist das erste HowTo auf dieser Seite und ich hoffe es werden noch mehrere Folgen.
In diesem HowTo geht es um die eBay API. die eBay API kann eine ganze Menge - ich würde beinah meinen, man kann mit der API fast alles machen, was man auch auf der eBay Seite machen kann: Suchen, Bieten, Kaufen, Verkaufen, Kommentare hinzufügen, Bewerten usw.
Die hier ist der erste Teil - alles was man für den Einstieg braucht. In den nächsten HowTos geh ich dann direkt auf das Programmieren mit der API in Zusammenhang mit .NET ein.
Wie auf unserer ShoppingMap zu sehen ist, verwenden wir die eBay API. Wenn man auf www.ebay.de etwas weiter runterscrollt, fällt einem der Link hier auf: Entwicklerprogramm
Neben der eBay API bietet eBay selber noch mehrere andere interessante Entwicklerprogramme an, die bekanntesten sind aber wohl:
Voraussetzung für das Nutzen der eBay API
Die eBay API kann jeder Nutzen und ist auch völlig kostenlos. Bedingung ist, dass man ein “normales” eBay Benutzerkonto hat und sich als eBay Entwicklermitglied registriert. Die richtigen eBay Entwicklerseiten sind alle auf englisch. Was aber für alle deutschsprachigen eBay Entwickler interessant sein dürfte sind folgende Sachen:
Wer sich mehr mit der eBay API beschäftigen will, für den ist vielleicht auch die 1. eBay Entwicklerkonferenz in München nicht verkehrt.
Nachdem man nun als eBay Entwickler unter der englischsprachigen Developer Seite angemeldet ist, braucht man bevor man direkt startet noch 3 Keys und ein Token. Details zu allem, was jetzt hier steht, findet Ihr natürlich auch auf der Entwicklerseite von eBay: Quickstart
Um Ihre Anwendung zu Testen, stellt eBay eine Testumgebung bereit, da es ja sehr gefährlich sein kann, nur mal so zum Testen 20 neue Produkte einzustellen ;)
eBay Keys und Tokens
Daher gibt es Sandbox und Productiv Keys.
Um die Sandbox nutzen zu können, muss man sich (ähnlich wie auf der richtigen eBay Seite) einen Sandbox User anlegen. Die kann unter dem Menüpunkt “My Account” geschehen. Da ich selber nur auf eBay suche, habe ich auch nie einen Sandbox User angelegt und fahre deshalb gleich mit den Productiv Keys fort.
Um diese Keys zu erhalten, muss man einen kleinen Fragebogen zur Applikation ausfüllen. Nachdem dieser erfolgreich bestanden ist, bekommt man seine Keys mitgeteilt (und kann zudem 10.000 Aufrufe pro Monat an eBay schicken) und kann nun fortfahren, zum User Token.
Beim Auth & Auth Token Generator bekommt man nun sein User Token. Hier ist die Unterscheidung zwischen Productiv und Sandbox wichtig.
Nachdem man nun alle 3 Keys (DevID, AppID, CertID) zusammenhat und auch das Token nicht fehlt kann man hier seine Keys und auch die ersten Aufrufe mal testen.
Weiterführendes
Die eBay API wurde für viele Programmiersprachen ausgelegt und unterstützt diese auch, darunter PHP, die .NET Familie, Java… SOAP, XML und REST spielen auch eine Rolle. Für jedes einzelne gibt es sehr umfangreiche Dokumentationen. Wenn man seine Anwendung, wie z.B. ShoppingMap, erfolgreich aufgebaut hat und feststellt das 10.000 Aufrufe pro Monat sehr knapp sind oder man in das Applikationsverzeichnis von eBay will, kann man dies auch völlig kostenlos machen:
Nach erfolgreichen Bestehen der Standard Prüfung darf man das “Compatible Application” Logo nutzen.
Logos - was man darf und nicht.
Beim nächsten HowTo werde ich die API Aufrufe erklären und zeigen, welche auch auf ShoppingMap zum Einsatz kommen. Bis dahin…