Tools4Etsy

24th June 2011 - v2.00.019b

Added: New Treasury Create/Delete & TreasuryComments Find/Post/Delete API support. Sample Code added.

Updated: JSON to POCO code refactored & optimized - Applies to all versions of the Library.

18th June 2011 - v2.00.018b

Added: Full API Cart support.

Added: Support for new Etsy Dual key set for Sandbox Mode (Read/Write sandbox, Read-only Live) is now built into the library. No change required for LIVE applications/websites.

1. Defaults to Consumer/Consumer_Secret key set only (Write). New Constructor & KeyMode property in OAuthCredentials and exEtsyNet classes.
2. If using the EtsyNet class, changing the KeyMode is done through the Credentials property. For exEtsyNet class, A new KeyMode property is added.
3. KeyMode property allows for switching Sandbox Key Sets on the fly without the need to reinitialize or using to instances of the library.
4. Sample code added.

Bugfix: Fixed uploading image and data for uploadListingImage & createListing API methods.

8th June 2011 - v2.00.017b

Added: Read-only support for the new user Carts. Cart, Cart Listing, and Coupon resources with collections plus new method calls getAllUserCarts, getUserCart.

3rd June 2011 - v2.00.016b

Updated: BREAKING CHANGE Etsy have changed the requirements to work with Shop Sections methods - shop_id is now required in the calling parameter.

6th May 2011 - v2.00.015b - ETSY V2 API R:72 M:64

Added: the Team resource and related methods.

3rd May 2011 - v2.00.014b- ETSY V2 API R:72 M:64

Updated: BREAKING CHANGE Added min_created and max_created parameters to findAllShopReceipts and findAllUserOrders..

Updated: BREAKING CHANGE ETSY Removed deprecated associations: Listing.FavoredBy, User.FavoredBy, User.FavoriteListings, User.FavoriteUsers, User.FeedbackAsAuthor, User.FeedbackAsSubject, User.FeedbackAsBuyer, User.FeedbackAsSeller. The same data is still available in other API method calls.

Bugfix: Fixed issue with OAuth encoding throwing errors for '&' and '=' characters used in text (eg: Listing's description field); '+' is currently being converted to ' ' by Etsy - awaiting Etsy fix.

20th April 2011 - v2.00.013b- ETSY V2 API R:72 M:64

Updated: BREAKING CHANGE Added a new filename (image param) for method createListing to allow for simultaneous upload of the main image when creating a listing. At some point in the future, Etsy will require uploading at least one image will be required when creating a listing.

Updated: BREAKING CHANGE Added sort_order field to findAllUserCharges.

14th April 2011 - v2.00.012b- ETSY V2 API R:72 M:64

Added: missing title field to create createShippingTemplate method - thanks to Aleksandar Miljusevic for pointing this out!

Added: Additional parameter sort_order to findAllUserCharges to allow for retrieving BillCharges from latest to oldest.

Added: NEW CreateListing Console sample project - demonstrates checks and balances with error correction required to create a listing.

Updated: Method uploadListingImage now accepts a parameter to specify a rank for the ListingImage.

Updated: Deprecated associations of User and Listing resources that deal with Feedback, FavoriteUser and FavoriteListing.

Updated: Removed the Shops and User associations of UserProfile.

29th March 2011 - v2.00.011b- ETSY V2 API R:72 M:64

Removed: Shops & User associations for UserProfile Resource marked obsolete & will now return nothing as Etsy has removed these from the API.

18th March 2011 - v2.00.010b- ETSY V2 API R:72 M:64

Added: Missing createPaymentTemplate & updatePaymentTemplate.

Bugfix: paypal_email property in PaymentTemplate was of incorrect type - fixed.

8th March 2011 - v2.00.009b- ETSY V2 API R:72 M:64

Added: New Silverlight MVVM Sample Project - Test MVVM EtsyNetSL. Demonstrates Asynchronous Public API calls and error handling with retries. This project is using the same core code as the Test EtsyV2Net4 project and demonstrates the similarities between Silverlight 4.0 & WPF 4.0.

Updated: WPF4 MVVM Sample Project to share source files with new Silverlight MVVM Sample Project.

Updated: Added null check to HasMoreData method in EtsyAsyncDataPacket class.

Updated: Listing, Shop, & Shipping Create and Update methods to allow Field and Includes for returned data.

Bugfix: Fixed issue with Async Comms encoding & file security for uploading Silverlight Images - Images must reside in root of IsolatedStorage folder.

Bugfix: Added missing user_address_id parameter to method updateUserAddress.

15th February 2011 - v2.00.008b- ETSY V2 API R:72 M:64

Added: Tracking Response Header Data (at the request of Justin from Etsy) to the WebQuery class (IResponse Interface) to track additional information for feeding error information to Etsy.

Added: findAllShopListingsFeatured method.

Patch: Monetary fields changed from decimal to string for remaining resources BillCharge, BillPayment, Receipt, ShippingInfo, ShippingTemplateEntry, Transaction (see comments below from 25/1/2011).

Bugfix: Errors found in Compress method in Listing class for ListingPayment & MainImage associations.

12th February 2011 - v2.00.007b- ETSY V2 API R:72 M:64

Updated: Etsy has changed from 404 Not Found to returning Empty JSON data - added check to all serialization methods in Response module.

9th February 2011 - v2.00.006b- ETSY V2 API R:72 M:64

Added: New EtsyV2Net4 Library for Framework 4.0 support as requested.

Added: New WPF4 Sample Project called 'Test EtsyV2Net4' built using the MVVM design pattern that demonstrates Asynchronous Public API calls and error handling with retries.

Updated: Tightened code in method findAllListingActive to avoid unhandled error.

Bugfix: image_listing_id was incorrectly merged in Compress routine of the Transaction class (Thanks Chris Zimmerle for the fix!).

3rd February 2011 - v2.00.005b - ETSY V2 API R:72 M:64

Updated: EtsyAsyncDataPacket with new Data property. For tracking the multi-call collection of Etsy data from within Lambda expressions (C#: 3.5sp1+, VB: 4.0) in Async operations. Sample application added to demonstrate usage.

Updated: Method _StartAsync In Webquery class - changed to internal http stack, for Silverlight Public calls, as the default browser stack only supports two simultaneous calls plus does not return the header response data - required for reading Mashery response Status/Feedback.

Updated: Changed all debugging output to use System.Diagnostics.

25th January 2011 - v2.00.004b - ETSY V2 API R:72 M:64

Patch: Etsy announced today, without warning, that the price field in Listing and TreasuryListingData resources was changed from float to string. We've applied an urgent patch to fix this breaking change.

Patch: Added Patch to handle an odd error thrown by Treasury method calls where Etsy puts the error message in the body instead of the response header.

5th January 2011 - v2.00.003b - ETSY V2 API R:72 M:61

Added: New Private methods getRecommendedListings, registerRecommendedListingRejects & registerRecommendedListingViews.

Bugfix: OAuth consecutive Verification retry after a successful/failed attempt would throw a "401 Unauthorized" error if the same Credentials class was used - Fixed.

Bugfix: findAllListingActive, findAllShopListingsActive Color was passed as black and accuracy 0 when not set - fixed.

Patch: Listings resource returned by Etsy returns an empty 'materials' field as the incorrect type. Silverlight Framework cannot handle incorrect data mappings. I've applied a temporary fix until Etsy corrects this problem.

23rd December 2010 - v2.00.002b - ETSY V2 API R:72 M:60

Added: missing 'Addresses' association to User Resource (Thanks Chris Zimmerle for pointing this out!).

Added: missing private 'name' field to Shop resource.

Added: missing private 'country_name' field to UserAddress resource.

20th December 2010 - ETSY V2 API R:72 M:60

Due to Etsy's change in documentation we've changed our version numbering system.

8th December 2010 - ETSY V2 API R:70 M:59

Bugfix: An exception error was thrown during the data deserialization if Etsy returned an Empty JSON Data Packet. Empty Resource object will be returned with no error thrown.

Bugfix: Changed processing of Call Parameters to not be modified to allow for retries with the same WebQuery Object (See MVC project for handling 500/502/503/504 error retries).

Change: Made iResponse Interface for WebQuery Object Public.

Cleanup: Tightened up code and minimised debug code ready for release.

Added: ASP.NET MVC2 Sample code.

24th November 2010 - ETSY V2 API R:69 M:58

Added: image_url_155x125 field to Feedback resource in EtsyV2Net, EtsyV2NetSL & EtsyV2Cache.

15th November 2010 MAJOR UPDATE (PRE-RELEASE)

MS Languages supported (tested): C# & VB.NET

MS platforms supported: Winforms, WPF 4.0, Silverlight 4.0, ASP.NET Classic, & ASP.NET MVC

MS platforms pending: Windows Phone 7

This version contains breaking changes that were unavoidable - please see demo projects for new calling syntax.

Redesigned: Refactored Libraries to add support for Asynchronous execution. Synchronous calls still supported. Now OAuth 1.0a fully compliant.

Added: exEtsyNet to support the old calling syntax with full CRUD (Create, Read, Update, Delete) & Image Upload API support.

Added: New Project Library for Silverlight called EtsyV2NetSL.

Added: Class EtsyAsyncDataPacket as a support class (usage is not compulsory - can use own) for tracking key data when working Asynchronous calls. See demos for usage.

Added: More Sample Projects for new functionality - Async Winform demo, Silverlight Demo.

Updated: EtsyV2CACHE to work with the new syntax using the new exEtsyNet - only required updating of initialising library in Internals.vb & EtsyCache.vb files.

Updated: EtsyV2CACHE to support Shops resource with new findAllShops & FeaturedUser resource with the new findAllFeaturedUsers.

Added: Full support for OAuth 1.0a (used by Etsy) - POST, PUT, & DELETE methods.

Added: Support for Create/Update/Delete/Upload API calls:

1. User: createUserAddress, updateUserAddress, deleteUserAddress, uploadAvatar;
2. Shop: createShopSection, updateShopSection, deleteShopSection, updateShop, uploadShopBanner, deleteShopBanner;
3. Listing: createListing, updateListing, deleteListing;
4. Listing Image: uploadListingImage, deleteListingImage
5. Shipping: createShippingInfo, updateShippingInfo, deleteShippingInfo;
6. Shipping Template: createShippingTemplate, updateShippingTemplate, deleteShippingTemplate, createShippingTemplateEntry, updateShippingTemplateEntry, deleteShippingTemplateEntry;
7. Payment: createPaymentTemplate, updatePaymentTemplate;
8. Favorites: (Already implemented - updated for new Async support) createUserFavoriteListings, deleteUserFavoriteListings, createUserFavoriteUsers, deleteUserFavoriteUsers;
9. Sales Data: updateReceipt;

Added: findAllFeaturedListingPickerListingsActive, findAllShippingTemplateEntries method.

Added: findAllUserAddresses, getUserAddress, getAvatarImgSrc private methods.

Added: ToString Override to Category, Country, Listing, Region, Shop, Tag, Treasury and User resources.

Added: Exception for JSON Deserialization errors caused by unexpected changes/errors in data returned by Etsy.

Removed: Resource Fields and Methods flagged by Etsy as DEPRECATED (Obsolete) are now removed from the Library.

This library is currently not live for download. If you're interested in helping with the testing, please Contact Us.

5th November 2010

Added: New Etsy FeaturedUser Resource plus findAllFeaturedUsers & getFeaturedUser methods.

Updated: findAllShops method to take a new optional parameter shop_name that matches the beginning of a Shop shop_name. According to the Etsy documentation, the param must be three characters or longer.

3rd November 2010

Added: num_favorers field was finally added to Shop and Listing resources - Library updated with num_favorers field. EtsyV2Cache depreciates 'smart loading' num_favorers for Etsy v2 API Listing/Shop resource num_favorers field.

2nd November 2010

Added: New Etsy MainImage association to Listing resource.

Added: New Etsy private buyer_email & seller_email fields to Receipt resource.

Added: New Etsy url fields to Shop resource.

31st October 2010

Change: Etsy dropped the favorite_listing_id field for FavoriteListing resource - now merging duplicate data by create_date (unique identifier).

Change: Etsy dropped the favorite_user_id field for FavoriteUser resource - now merging duplicate data by creation_tsz (unique identifier).

17th October 2010

Change: A patch to fix an etsy bug where Etsy reports active listings (sidebar reports active listings) but there are no active listings. This is a bug that Etsy is aware of but won't fix.

23rd September 2010

Change: ** BREAKING CHANGE ** Etsy is rolling out changes to the Favorites system. Fixed problem with loosing FavoriteListings for FavoredBy association for Listings. Also, Etsy has depreciated favorite_listing_id (returns null), creation_tsz, & state fields; added create_date field to replace creation_tsz & listing_state field to replace state.

15 September 2010

Added: Etsy Resource Page and Method Page version numbers to this Revision information document to simplify library version tracking. This information is available from EtsyV2Net Library.

Added: url field to Transaction resource

Change: Some fields for Transaction resource/class have changed from private to public - see Etsy API documentation for more information.

BugFix: url field in FeaturedListingPicker was set to the wrong case causing the URL not to return nothing.

Updated: getServerEpoch & ping internal JSON conversion broke. Updated internal code to support Etsy's additional returned JSON fields params & type added to API 11/09/2010.

3rd September 2010

Change: ** BREAKING CHANGE ** date_tsz fields from Etsy have changed from int to float to 'use microseconds instead of seconds. The change was necessary to maintain proper sort order in some places.'

1st September 2010

Added: ShopBanner class

Added: findAllUserPaymentTemplates method

Updated: findAllShopListings to support Etsy's new Shop Listing search and ordering functionality.

Changed: findAllUser & findAllUserActive API removed by Etsy - corrected library to reflect this. If called will now set response code to Not_Implemented and throws the error.

Changed: findAllShopListingsExpired, getShopListingExpired, findAllShopListingsInactive, & getShopListingInactive Changed to Private calls to match Etsy's changes.

Changed: Etsy moved listing_payment_id, allow_check, allow_mo, allow_other, & allow_paypal fields from private to public - source code now reflects these changes.

BugFix: Etsy has fixed the error with findAllTreasuries and sort_on = created.

24th August 2010

Added: findAllUserActive, findAllShopListingExpired, getShopListingExpired, findAllShopListingInactive, getShopListingInactive methods

Added: getListingPaymentInfo, getListingPayment, getPaymentTemplate methods

20th August 2010

Added: ShopSections collection & shop_section_id property to Listing class

18th August 2010

Added: New UserAddress and UserAddresses classes

Added: Casting to & From List(of T) for Resource Collection Classes

10th August 2010

Added: Self compression to resource collections & classes. EtsyNet method calls automatically call the compression routines to ensure no duplicate results based on Includes - Fixes Etsy bug

Added: Obsolete attribute to fields that have been marked as obsolete or removed by etsy. Intellisense will notify you if you try to use one of these fields

Bugfix: user_profile_id & user_id were incorrectly typed in UserProfile - changed from String to Integer

Bugfix: price field in Listing changed to nullable type

Bugfix/Change: Changed getOrder, getReceipt, getTransaction methods to support retrieval of an array of ids

7th August 2010

Added: New Treasury API: Treasury, TreasuryListing, TreasuryCount, TreasuryListingData resources; getTreasury, findAllTreasuries & findAllUserTreasuries Methods

Added: PaymentTemplate, PaymentTemplates(of PaymentTemplate) resources

Added: findAllFeaturedListingPickerActive, findAllFeaturedListingPickerFeatured method

Added: IncludesHelper - helps construct/deconstruct and validates Include structure (syntax only) for API calls. Will also correct field case

Added: ListingPayment and Treasury collections & classes

Added: ListingPayment property to Listing class

Moved: getFeaturedListingPicker to new HomePage EtsyNet partial class

Bugfix/Change: Changed Keyword parameter to optional in findAllListingActive

6th August 2010

Bugfix/Change: Changed return type from FavoriteUser to FavoriteUsers(of FavoriteUser) for getUserFavoriteUsers method

5th August 2010

Removed: Offset & limit parameters from findAllCountry & findAllRegion functions in EtsyNet (as per Etsy)

3rd August 2010

Change: Method type to string in onAPICall Event in EtsyNet

Bugfix: Corrected support for Sandbox mode for SetVerificationCode function in EtsyNet - spotted by Tom Follett

28th July 2010

Added: FeaturedListing, FeaturedListings(of FeaturedListing), FeaturedListingPicker, FeaturedListingPickers(of FeaturedListingPicker) resources

Added: getFeaturedListing, getFeaturedListingListing, findAllFeaturedListingPickerListings, getFeaturedListingPicker, findAllShopSection, getShopSection methods

27th July 2010

Added: findAllFeaturedListingActive methods

Added: Support for multiple country_ids in getCountry method parameters

Added: Support for multiple region_ids in getRegion method parameters

21st July 2010

Added: 760x100 banner field to Shop resource

Added: country_id, city, image_url_75x75 fields & Removed tags, location fields in USerProfile resource (as per Etsy)

Change: Shop association changed to Shops(of Shop) in UserProfile resource

NOTE: transaction_buy_count & transaction_sold_count fields & Country association now public in UserProfile

NOTE: Image sizes supported by Etsy changed & we've updated library to reflect these changes - more info can be found here: http://developer.etsy.com/docs/images

12th July 2010

Added: new Etsy Sandbox API support

10th July 2010

Added: findAllUserCharges, find allUserPayments, findAllUserShippingTemplates methods

Added: BillCharge, BillCharges(of BillCharge), BillPayment), BillPayments(of BillPayment), ShippingTemplate, ShippingTemplates(of ShippingTemplate), ShippingTemplateEntry, ShippingTemplateEntries(of ShippingTemplateEntry) resources

Added: BillCharges(of BillCharge), BillPayments(of BillPayment) associations to User resource

Added: FeedbackInfo undocumented resource to User resource

9th July 2010

Added: PostData to onAPICall Event in EtsyNet passing the raw JSON data received

Added: EtsyAPIBuildVersion to EtsyNet to return the supported Etsy API Resources & Methods - returns "ETSY v2 API R:xx M:yy" to reflect versioning as identified at the bottom of the Etsy documentation pages

Change: Resultcode type for APICallComplete Event in EtsyNet

Removed: "CallbackUrl" property from EtsyNet as it's a single use param for getting Private USer Access Token & Secret keyset

Moved: API methods, Responses, etc... to own partial classes in for code manageability

Moved: onAPICall event call to oAuth class to allow for private URL encoding to be correctly reported; added event bubbling from oAuth in EtsyNet

BugFixes: Initialised Token & TokenSecret; CallBackURL check & reset after use in GetVerificationURL in EtsyNet

30th June 2010

Bugfix: Better support for special characters in OAuth encoding in OAuth class (pending re-write required to correct issue with special character support for POST mode operation)