HowTo: eBay API (Suchen mit eBay…)

Willkommen zurück zum HowTo über die eBay API.

Sobald die Grundvoraussetzungen für die API Nutzung erfüllt sind, kann es auch schon direkt losgehen.

Unser Ziel ist es, eine Suchanfrage an eBay zu schicken.

eBay API in Visual Studio nutzbar machen

Um nun die eBay API auch im Visual Studio komfortabel zu nutzen, fügt man eine “Web Referenz” dem Projekt hinzu:

-> Projektmappen Explorer -> Web References *Rechtsklick* -> Webverweis hinzufügen: https://api.ebay.com/wsapi

Diese Adresse enthält die Schnittstellendefinition von eBay. Wenn Visual Studio vielleicht meckert, dass bestimmte Elemente in der Beschreibung falsch sind helfen zwei Sachen:

  • Nochmal versuchen
  • Ignorieren

Ich weiß leider nicht mehr genau woran es lag, aber bei mir hat es 5 Versuche gedauert, bis mein Visual Studio 2005 es komplett geschluckt hatte. Falls dann immer noch Fehler bei euch auftreten: Einfach ignorieren – seltsamerweise funktioniert es doch und sie verschwinden irgendwann.

Nachdem man das geschafft ist, kann man im Klassenexplorer sich mal die API anschauen, wie man feststellt ist es doch sehr umfangreich. Keine Angst, man braucht niemals alles – jedenfalls erstmal nicht ;)

Die Suchanfrage
Da man für jede Suchanfrage die 3 Keys und das Token eingeben muss, habe ich mir eine kleine Klasse geschrieben, die das übernimmt:

public class InterfaceService 
{ 
   #region Properties 
   private eBayAPIInterfaceService eBayService = new eBayAPIInterfaceService();       

   public eBayAPIInterfaceService EBayService 
    { 
    get { return eBayService; } 
    set { eBayService = value; } 
   }       

#endregion       

public InterfaceService(string callName) 
{ 
string endpoint = "https://api.ebay.com/wsapi"; 
string siteId = "77" // Deutsche eBay Seitestring 
appId = "" // AppIDstring 
devId = "" // DevIDstring 
certId = "" // CertIdstring 
version = "495" // API Version 
string eBayAuthToken = ""  // Token       

this.EBayService.Url = endpoint + 
                             "?callname=" 
                              + callName+ 
                              "&siteid=" + siteId+ 
                              "&appid=" + appId+ 
                              "&version=" + version+ 
                              "&routing=default"       

this.EBayService.RequesterCredentials = new CustomSecurityHeaderType(); 
this.EBayService.RequesterCredentials.Credentials = new UserIdPasswordType(); 
this.EBayService.RequesterCredentials.Credentials.AppId = appId; 
this.EBayService.RequesterCredentials.Credentials.DevId = devId; 
this.EBayService.RequesterCredentials.Credentials.AuthCert = certId; 
this.EBayService.RequesterCredentials.eBayAuthToken = eBayAuthToken; 
} 
}

So… eine sehr einfache Klasse, welche aber (jedenfalls mir) das eBay Leben erleichtert hat. Ich hoffe der Code wird hier nicht arg zu sehr vermurkst durch den Blog.

So… nachdem man das gemacht hat, wollen wir aber direkt mal eine Suchanfrage durchführen (in einem oldschool Konsolenprogramm):

InterfaceService MyeBay = new InterfaceService("GetSearchResults");       

GetSearchResultsRequestType SearchRequest = new GetSearchResultsRequestType(); 
SearchRequest.Query = "Schrank"; 
SearchRequest.Version = "495"; 
   try 
   { 
   GetSearchResultsResponseType SearchResponse = new GetSearchResultsResponseType(); 
   SearchResponse = MyeBay.EBayService.GetSearchResults(SearchRequest);       

      for (int i = 0; i <= SearchResponse.SearchResultItemArray.Length; i++) 
      { 
      System.Console.WriteLine(SearchResponse.SearchResultItemArray[i].Item.Title); 
      }       

   System.Console.Read(); 
   } 
   catch (Exception e) 
   { 
   System.Console.WriteLine(e.Message); 
   System.Console.Read(); 
   }

Dieses Beispiel ist sehr einfach, aber ich glaube, hier wird langsam klar, wofür ich die InterfaceService Klasse gebraucht habe – ich brauche in diesem Code keine Keys angeben.

Das Ergebnis von diesem Code ist einfach: Ausgabe von 100 aktuellen Schränke die bei eBay gelistet werden.

Es wird eine Exception ausgelöst, wenn die Suche keine Ergebnisse brauchte, Ihr könnt gerne mal das Suchwort (also SearchRequest.Query) ändern.
Trotz dessen, dass wir in der InterfaceService Klasse die Version angegeben haben, muss sie hier trotzdem beim eigentlichen Request mit angegeben werden.

Auf www.shoppingmap.de findet ihr noch 2 andere Details, die für die Suche hilfreich sein können:

- Kategorien
- Umkreis

Diese beiden Sachen, insbesondere, wie man leicht auf die Kategorien von eBay zugreifen kann, kommt dann demnächst.

Grüße

Letzte Posts

  • image_thumb.png
    NuGet Package Restore & Build Server wie z.B. AppVeyor

    NuGet ist ja mittlerweile weit verbreitet, aber eine Frage stellt sich natürlich immer noch: Checkt man die NuGet Packages ein oder nicht? In meinem kleinen Side-Projekt, welches auf GitHub liegt und ich über AppVeyor auch bauen lasse nutze ich das Package Restore Feature von NuGet, d.h. in meinem Repository befindet sich kein NuGet Package mehr, […]

  • image.png
    Microsoft Account Login via ASP.NET Identity

    Der Microsoft Account ist die zentrale Identifikationsstelle in der “Consumer-Microsoft-Welt”, allerdings ist das Einbinden eben dieser in die eigene Applikation eher schwierig. Das “Live SDK” ist nun unter dem OneDrive Dev Center zu finden und ganz professionell wurden auch alle Links zum alten Live SDK damit unbrauchbar gemacht. Beim Microsoft Account ist es auch unmöglich […]

  • image.png
    Zeitgesteuerte Azure WebJobs – so einfach kann Azure sein

    Das noch in Entwicklung befindliche Azure WebJob SDK bietet einige coole Features zum Verarbeiten und Bereitstellen von Daten. Bekanntes Beispiel ist das Sample welches auf eine Azure Queue lauscht und sobald ein Item da vorhanden ist anfängt dies zu verarbeiten. Szenario: Zeitgesteuerte Aktivitäten – ohne Queue und co. Mein Szenario war allerdings wesentlich trivialer: Ich […]

  • image.png
    Get Involved in OSS! Ja, aber wie geht das denn mit GitHub?

    Auch im .NET Lager gibt es Bewegung im OSS Bereich und es gibt verschiedene Arten wie man bei einem Open Source Projekt “Contributed”. Was zählt alles zu “Contribution”? Unter “Contribution” läuft eigentlich alles – ob es Fragen/Probleme zu dem Projekt via Issues ist oder Dokumentation nachreicht oder ob man darüber bloggt oder das Projekt vorstellt. […]

  • HowTo: Web.config samt eigener ConfigSection zur Laufzeit ändern

    In dem HowTo geht es darum wie man die Web.config zur Laufzeit ändert und was es dabei zu beachten gilt. Das ganze klappt auch mit komplexeren ConfigSections. Eigene ConfigSection? Vor einer ganzen Weile habe ich mal über das Erstellen einer eigenen ConfigSection geschrieben – im Grunde nutzen wir jetzt fast dieselbe Config. Zur Laufzeit? Startet […]

Support us!