etsy/open-api 3.0.0-alpha-2021-06-14

Alpha release: 3.0.0-alpha-2021-06-14

on GitHub

We no longer require active Etsy developers to request access to Open API v3 endpoints. Your existing API keys will work with all of the new endpoints.

Added

• uploadListingFile is now an Alpha endpoint
• The following endpoints had 404 added as possible response values:
  • getListingShippingProfileDestinationsByShippingProfile
  • getListingProperties
  • updateListingShippingProfileUpgrade
  • getListingShippingProfileUpgrades
• bio, gender, birth_month, birth_day, transaction_buy_count, transaction_sold_count, is_seller, first_name and last_name fields to getUser endpoint
• getListingsByListingIDs endpoint in Alpha state
• updateListingAttributes is now an Alpha endpoint

Changed

• Reference documentation has moved to https://developers.etsy.com/documentation/reference. Later this week, the old URL will redirect to the new one.
• updateListing no longer allows listing renewal when shop is on vacation
• findShops now returns an non-indexed array per the documentation
• getListing now returns 404 when a deleted listing is requested
• getListingProduct now require oauth scope of listings_r instead of listings_w
• “State” field in getListings endpoint is not required anymore. It defaults to “active”.
• getListingsByShopSectionId now used request params for shop_section_ids instead of URL params
• getShippingCarriers no longer requires an oauth scope

Route updates

• deleteListingFile
  • O : DELETE /v3/application/listings/{listing_id}/files/{listing_file_id}
  • N : DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}
• getListingFile
  • O : GET /v3/application/listings/{listing_id}/files/{listing_file_id}
  • N : GET /v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}
• uploadListingFile
  • O : POST /v3/application/listings/{listing_id}/files
  • N : POST /v3/application/shops/{shop_id}/listings/{listing_id}/files
• getShopReceiptTransactionsByShop
  • O : POST /v3/application/transactions
  • N : POST /v3/application/shops/{shop_id}/transactions
• getShopReceiptTransaction
  • O : GET /v3/application/transactions/{transaction_id}
  • N : GET /v3/application/shops/{shop_id}/transactions/{transaction_id}
• getListingImage
  • O : GET /v3/application/shop/{shop_id}/listings/{listing_id}/images/{listing_image_id}
  • N : GET /v3/application/shops/{shop_id}/listings/{listing_id}/images/{listing_image_id}
• getAllListingFiles
  • O : /v3/application/listings/{listing_id}/files
  • N : /v3/application/shops/{shop_id}/listings/{listing_id}/files
• getListingsByShopSectionId
  • O : /v3/application/shops/{shop_id}/sections/:shop_section_ids/listings
  • N : /v3/application/shops/{shop_id}/shop-sections/listings