1Net-eBay
2
3This module allows users to communicate with eBay using perl and their
4XML based eBay API. You can use it to list items for sale, bid, get
5seller item list, search, get ebay time, or do anything else.
6
7Many details of this API can be found at http://developer.ebay.com. To
8be able to use this module, you need to register there and obtain keys
9and a authentication token using "tokentool".
10
11The job of its module is to encapsulate connectivity and
12authentication, and communication with ebay. First, you need to
13initialize your ebay connection by passing it credentials. After that,
14you can send queries to eBay. A typical request is comprised of its
15name, and a hash table of application parameters.
16
17It supports BOTH New and Legacy API (Legacy API will expire in summer
182006).
19
20Example of listing an item for sale:
21
22 use Net::eBay;
23 use Data::Dumper;
24
25 my $ebay = new Net::eBay( {
26 site_level => 'prod',
27 DeveloperKey => '...',
28 ApplicationKey => '...',
29 CertificateKey => '...',
30 Token => '...',
31 } );
32
33 my $result = $ebay->submitRequest( "AddItem",
34 {
35 DetailLevel => "0",
36 ErrorLevel => "1",
37 SiteId => "0",
38 Verb => " AddItem",
39 Category => "14111",
40 CheckoutDetailsSpecified => "0",
41 Country => "us",
42 Currency => "1",
43 Description => "For sale is like new <A HREF=http://www.example.com/jhds/>thingamabob</A>.Shipping is responsibility of the buyer.",
44 Duration => "7",
45 Location => "Anytown, USA, 43215",
46 Gallery => 1,
47 GalleryURL => 'http://igor.chudov.com/images/mark_mattson.jpg',
48 MinimumBid => "0.99",
49 BuyItNowPrice => 19.99,
50 PayPalAccepted => "1",
51 PayPalEmailAddress => "ichudov\@example.com",
52 Quantity => "1",
53 Region => "60",
54 Title => "Igor's Item with Gallery xaxa",
55 }
56 );
57
58 print "Result: " . Dumper( $result ) . "\n";
59
60Result of submitRequest is a perl hash obtained from the response XML using XML::Simple, something like this:
61
62 Result: $VAR1 = {
63 'Item' => {
64 'Id' => '4503546598',
65 'Fees' => {
66 'FeaturedGalleryFee' => '0.00',
67 'InternationalInsertionFee' => '0.00',
68 'CurrencyId' => '1',
69 'GalleryFee' => '0.25',
70 'AuctionLengthFee' => '0.00',
71 'ProPackBundleFee' => '0.00',
72 'BorderFee' => '0.00',
73 'FeaturedFee' => '0.00',
74 'SchedulingFee' => '0.00',
75 'HighLightFee' => '0.00',
76 'FixedPriceDurationFee' => '0.00',
77 'PhotoDisplayFee' => '0.00',
78 'ListingFee' => '0.55',
79 'BuyItNowFee' => '0.00',
80 'PhotoFee' => '0.00',
81 'GiftIconFee' => '0.00',
82 'SubtitleFee' => '0.00',
83 'InsertionFee' => '0.30',
84 'ListingDesignerFee' => '0.00',
85 'BoldFee' => '0.00',
86 'ReserveFee' => '0.00',
87 'CategoryFeaturedFee' => '0.00'
88 },
89 'StartTime' => '2005-08-30 04:50:47',
90 'EndTime' => '2005-09-06 04:50:47'
91 },
92 'EBayTime' => '2005-08-30 04:50:47'
93 };
94
95
96
97THIS IS A NEW MODULE
98
99This module is new and may have bugs (gasp). Please contact Igor
100Chudov, ichudov AT algebra DOT com, maybe I could help you, or you
101could help me.
102
103INSTALLATION
104
105To install this module, run the following commands:
106
107 perl Makefile.PL
108 make
109 make test
110 make install
111
112
113COPYRIGHT AND LICENCE
114
115Copyright (C) 2005 Igor Chudov
116
117This program is free software; you can redistribute it and/or modify it
118under the same terms as Perl itself.
119
