creharmony / node-etsy-client

NodeJs Etsy Rest Client
MIT License
9 stars 8 forks source link

Improvement: Update Etsy API to v3 #39

Closed icemansparks closed 2 years ago

icemansparks commented 2 years ago

Since etsys API v2 will be discontinued and stop working by the end of the year as stated in the etsy documentation ( https://www.etsy.com/developers/documentation/getting_started/edd#section_update_your_app ), it would be wise to update the client to use etsys new v3 API - which is similar but not exactly the same.

Details can be found here: https://developers.etsy.com/documentation/

Great job here btw! It's nice to see an updated etsy node client.

creharmony commented 2 years ago

🧑‍💼 I start to work on it because there is a date for end of v2..

I'll put down here some dev remarks during implementation.


v2 findAllShops (no mandatory arg) => v3 findShops (shop_name required)

v2 getShop (shop name) => v3 getShop (shopId required) v2 findAllShopSections (shop name) => v3 getShopSections (shopId required) v2 findAllShopListingsActive (shop name) => v3 findAllActiveListingsByShop (shopId required)

v2 getListing => v3 getListing doc

v2 getVariationImages => v3 getListingVariationImages (adding shopId) v2 findAllListingImages => v3 getListingImages v2 getInventory => 🔴 v3 getListingInventory - not migrated for now : rely now on strong auth oauth2

v2 getAttributes => v3 getListingProperty (adding shopId) v2 getProduct => 🔴 v3 getListingProduct - not migrated for now : rely now on strong auth oauth2 v2 findAllListingShippingProfileEntries => 🔴 v3 no equivalent