NAME

eBay::API::Simple::Finding - Support for eBay's Finding 2.0 web service

DESCRIPTION

This class provides support for eBay's Finding 2.0 web services.

See http://developer.ebay.com/products/finding/

USAGE

my $call = eBay::API::Simple::Finding->new( 
  { appid => '<your app id here>' } 
);

$call->execute( 'findItemsByKeywords', { keywords => 'shoe' } );

if ( $call->has_error() ) {
   die "Call Failed:" . $call->errors_as_string();
}

# getters for the response DOM or Hash
my $dom  = $call->response_dom();
my $hash = $call->response_hash();

print $call->nodeContent( 'timestamp' );
print $call->nodeContent( 'totalEntries' );

my @nodes = $dom->findnodes(
  '//item'
);

foreach my $n ( @nodes ) {
  print $n->findvalue('title/text()') . "\n";
}

SANDBOX USAGE

my $call = eBay::API::Simple::Finding->new( { 
  appid => '<your app id here>',
  domain => 'svcs.sandbox.ebay.com',
} );

$call->execute( 'findItemsByKeywords', { keywords => 'shoe' } );

if ( $call->has_error() ) {
   die "Call Failed:" . $call->errors_as_string();
}

# getters for the response DOM or Hash
my $dom  = $call->response_dom();
my $hash = $call->response_hash();

PUBLIC METHODS

new( { %options } }

Constructor for the Finding API call

my $call = eBay::API::Simple::Finding->new( { 
  appid => '<your app id here>' 
  ... 
} );

Options

appid (required)

This appid is required by the web service. App ids can be obtained at http://developer.ebay.com

siteid

eBay site id to be supplied to the web service endpoint

defaults to EBAY-US

domain

domain for the web service endpoint

defaults to svcs.ebay.com

service

SOA Service name

defaults to FindingService

uri

endpoint URI

defaults to /services/search/FindingService/v1

version

Version to be supplied to the web service endpoint

defaults to 1.0.0

https

Specifies is the API calls should be made over https.

defaults to 0

ALTERNATE CONFIG VIA ebay.ini

The constructor will fallback to the ebay.ini file to get any missing credentials. The following files will be checked, ./ebay.ini, ~/ebay.ini, /etc/ebay.ini which are in the order of precedence.

# your application key
ApplicationKey=LJKGHKLJGKJHG

execute( $verb, $call_data )

 $self->execute( 'findItemsByKeywords', { keywords => 'shoe' } );

This method will construct the API request based on the $verb and the $call_data and then post the request to the web service endpoint.

$verb (required)

call verb, i.e. findItemsItemsByKeywords

$call_data (required)

hashref of call_data that will be turned into xml.

BASECLASS METHODS

request_agent

Accessor for the LWP::UserAgent request agent

request_object

Accessor for the HTTP::Request request object

request_content

Accessor for the complete request body from the HTTP::Request object

response_content

Accessor for the HTTP response body content

response_object

Accessor for the HTTP::Request response object

response_dom

Accessor for the LibXML response DOM

response_hash

Accessor for the hashified response content

nodeContent( $tag, [ $dom ] )

Helper for LibXML that retrieves node content

errors

Accessor to the hashref of errors

has_error

Returns true if the call contains errors

errors_as_string

Returns a string of API errors if there are any.

PRIVATE METHODS

_get_request_body

This method supplies the XML body for the web service request

_get_request_headers

This method supplies the HTTP::Headers obj for the web service request

_get_request_object

This method creates and returns the HTTP::Request object for the web service call.

AUTHOR

Tim Keefer <tim@timkeefer.com>

cpanm eBay::API::Simple

perl -MCPAN -e shell
install eBay::API::Simple