################################################################################
# File: ....................... README
# Original Author: ............ Jeff Nokes
# Last modified by: ........... Jeff Nokes
# Last modified: .............. 03/15/2007 @ 14:46
################################################################################





DESCRIPTION

eBay Perl SDK

This library is intended to provide a Perl based interface for the public eBay
web services API (http://developer.ebay.com).  Inside this library are a group
of modules used to provide eBay API generic and XML interface specific class
hierarchies, that are extended via the auto-generated API call/data-type
sub-classes.  The tools provided in this library contain a script used to
generate these sub-classes on the developer's behalf; please reference
INSTALL for more information on how to use this tool.

This is a pure-Perl library, that is almost entirely object oriented (OO).  And
in keeping with traditional Perl philosophies, it was decided to utilize as many
existing CPAN modules/libraries as possible, to implement it.

eBay Inc. currently supports the following interfaces to its API:

 REST (partially supported as of 12/11/2006)
 SOAP
 XML

This library currently supports the following eBay supported interfaces:

 XML

.. and was designed so that future support for other protocol
interfaces could be easily added.


This library includes the following features:

 (1)  Ability to make XML API calls to the eBay web services public interface
      using HTTP/HTTPS.

 (2)  Ability to: execute a single API call in a serial fashion; group multiple
      API calls to be executed in serial, or asynchronously in parallel via
      the LWP::Parallel module.

 (3)  Ability to stub out eBay API error responses for error handling testing,
      simulating a real API error, even though a real request was never sent.

 (4)  Ability to make most global library configurations using ENVironment
      variables and/or OO methods.

 (5)  Error exception class, extendable to the end-user's Perl application if
      one so chooses.

 (6)  Tool to auto-generate all specific API call/data-type classes.  As eBay
      up rev's its API interface version, the end-user can just re-generate
      all of the call/data-type classes with the new WSDL or Schema (.xsd)
      published by eBay.  (Reference INSTALL for more information)


For more information on how to use eBay's web services API, please visit the
publicly available web site, http://developer.ebay.com.





INSTALLATION

This library can be installed via the traditional Perl process of:

  perl Makefile.PL
  make
  make test
  make install

Users may also use `perl -MCPAN` if the module is available on CPAN mirrors.
Please reference INSTALL for more information on the recommended full
intallation process.





DEPENDENCIES

This module requires this version (or higher) of Perl:

  5.008001


This module requires these versions (or higher) of other modules and libraries:

  Compress::Zlib      v 1.41
  Crypt::SSLeay       v 0.51
  Cwd                 v 3.18
  Data::Dumper        v 2.121
  Devel::StackTrace   v 1.03
  Encode              v 1.9801
  Error               v 0.15
  Exception::Class    v 1.14
  Exporter            v 5.567
  File::Find          v 1.05
  File::Path          v 1.06
  File::Spec          v 3.18
  Getopt::Long        v 2.34
  HTTP::Headers       v 1.47
  HTTP::Request       v 1.34
  HTTP::Status        v 1.28
  IO::File            v 1.10
  LWP::Parallel       v 2.57
  LWP::UserAgent      v 2.023
  Params::Validate    v 0.74
  Scalar::Util        v 1.11
  Time::HiRes         v 1.51
  Time::localtime     v 1.02
  XML::Simple         v 2.09
  XML::Writer         v 0.600
  XML::Tidy           v 1.2.54HJnFa

Note:  The module versions mentioned above are the versions that this library
was developed and tested with.  It is assumed that all later versions of
these same modules will also work, but please reference each module's specific
documentation for it's functional API preservation, or lack thereof.





CREDITS

 Original authors/contributors in alphabetical order:

   Robert Bradley
   Mike Evans
   Milenko Milanovic
   Jeff Nokes

   [email protected]





COPYRIGHT AND LICENCE

Copyright (C) 1995-2006 eBay Inc. All Rights Reserved.

This library is licensed under the terms of the Common Development and
Distribution License ("CDDL").  The full text of this license is available
with this module distribution in the file named:

COMMON_DEVELOPMENT_AND_DISTRIBUTION_LICENSE.html

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.