PicoEBayTradingClient

Pico Objective-C Client for the eBay Trading API.

Note

1. This is only the proxy part of the PicoEBayTradingClient, you need to integrate with Pico Runtime before you can use this proxy, please follow instructions on Pico github site to add the Pico runtime library and the PicoEBayTradingClient in your iOS app, you may also start with the sample mentioned in Reference Sample section below.
2. You need to fill in eBayAppId and eBayAuthToken in EBayTradingServiceClient before your app can invoke eBay Trading service.
3. The proxy just suppose you hardcode the eBayAuthToken in EBayTradingServiceClient, in a real world app, for security consideration, you need to integrate with eBay Authentication & Authorization flow on your iOS device, and ensure the security of user credentils.
4. Besides proxy code, this site also hosts the appledoc for the PicoEBayTradingClient.

##Example Usage With this proxy and the generic Pico runtime library, eBay Trading API invocation on iOS platform is quite simple:

    // start progress activity
    [self.view makeToastActivity];
    
    // Get shared service client
    EBayTradingServiceClient  *tradingClient = [EBayTradingServiceClient sharedClient];
    tradingClient.debug = YES; // enable request/response message logging
    
    // Build request object
    Trading_GeteBayOfficialTimeRequestType *request = [[[Trading_GeteBayOfficialTimeRequestType alloc] init] autorelease];
    
    // make API call and register callbacks
    [tradingClient geteBayOfficialTime:request success:^(Trading_GeteBayOfficialTimeResponseType *responseObject) {
        
        // stop progress activity
        [self.view hideToastActivity];
        
        if ([Trading_AckCodeType_SUCCESS isEqualToString:responseObject.ack]) {
            NSString *dateString = [NSDateFormatter localizedStringFromDate:responseObject.timestamp
                                                                  dateStyle:NSDateFormatterShortStyle
                                                                  timeStyle:NSDateFormatterFullStyle];
            [self.view makeToast:dateString duration:3.0 position:@"center" title:@"eBay Official Time"];
        } else { // response residenet error
            Trading_ErrorType *error = [responseObject.errors objectAtIndex:0];
            [self.view makeToast:error.shortMessage duration:3.0 position:@"center" title:@"Error"];
        }
    } failure:^(NSError *error, id<PicoBindable> soapFault) {
        
        // stop progress activity
        [self.view hideToastActivity];
        
        if (error) {
            [self.view makeToast:[error localizedDescription] duration:3.0 position:@"center" title:@"Error"];
        } else if (soapFault) {
            SOAP11Fault *soap11Fault = (SOAP11Fault *)soapFault;
            [self.view makeToast:soap11Fault.faultstring duration:3.0 position:@"center" title:@"SOAP Fault"];
        }
    }];

        

##Docs

1. Wsdl Driven Development on iOS - the Big Picture
2. Pico and eBay Trading API integration How To

Reference Sample

Two samples have been created to demonstrate Pico integration with eBay Trading API, the first one is a hello world like sample, just call eBay Trading geteBayOfficalTime API to show official time on eBay server; the second one is a composite sample which calls eBay Finding, Shopping and Trading APIs behind:

1. Search items on eBay by keywords by invoking eBay Finding findItemsByKeywords API.

2. Show detail of an item by invoking eBay Shopping getSingleItem API.
3. Add item to watch list by invoking eBay Trading addToWatchList API.
4. View watch list by invoking eBay Trading getMyeBayBuying API.

You may review and study these samples before you create your own Pico and eBay API based app.

To run first sample, you must fill in your eBay AppId and eBay Auth Token in the shared client class EBayTradingServiceClient

To run second sample, you must fill in your eBay AppId in three shared client classes: EBayFindingServiceClient, EBayShoppingServiceClient and EBayTradingServiceClient, then fill in your eBay Auth Token in EBayTradingServiceClient, this just looks tedious and silly, I did so since this is just for demo, in real world app, I suggest you to centralize the credential setting in one place.

##Copyright and License (The MIT License)

Copyright (c) 2013 Leansoft Technology 51startup@sina.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE