etsy/open-api 3.0.0-beta-2021-07-12

on GitHub

Added

• Shop Management tutorial
• All listing responses now return is_supply
• Bug fixes

Changed

• Associations are now supported in these endpoints
  • getListingInventory
    • New “includes” parameter accepts the following association:
      • Listing
  • getListing
  • getListingByListingIds
    • New “includes” input parameter accepts comma delimited list of the following associations:
      • Shop
      • Images
      • User
• getListingsByShop
  • Added updated as a valid sort_on parameter
• Transaction endpoints now includes the Title or Description in the JSON output again
• createReceiptShipment
  • Requires either only a carrier name or tracking number with carrier name
• All listing responses now return shipping_profile_id instead of shipping_template_id
• updateListing now accepts is_supply as a request parameter

Shipping Profiles have been moved from the Listings perspective to the Shop perspective.

• createListingShippingProfile
  • New Name: createShopShippingProfile
  • New Route: /shops/:shop_id/shipping-profiles
• deleteListingShippingProfile
  • New Name: deleteShopShippingProfile
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id
• getListingShippingProfile
  • New Name: getShopShippingProfile
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id
• getListingShippingProfiles
  • New Name: getShopShippingProfiles
  • New Route: /shops/:shop_id/shipping-profiles
• updateListingShippingProfile
  • New Name: updateShopShippingProfile
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id

Shipping Profile Destinations have been moved from the Listings perspective to the Shop perspective.

• createListingShippingProfileDestination
  • New Name: createShopShippingProfileDestination
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/destinations
• deleteListingShippingProfileDestination
  • New Name: deleteShopShippingProfileDestination
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/destinations/:shipping_profile_destination_id
• getListingShippingProfileDestinationsByShippingProfile
  • New Name: getShopShippingProfileDestinationsByShippingProfile
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/destinations
• updateListingShippingProfileDestination
  • New Name: updateShopShippingProfileDestination
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/destinations/:shipping_profile_destination_id

Shipping Profile Upgrades have been moved from the Listings perspective to the Shop perspective.

• createListingShippingProfileUpgrade
  • New Name: createShopShippingProfileUpgrade
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/upgrades
• deleteListingShippingProfileUpgrade
  • New Name: deleteShopShippingProfileUpgrade
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/upgrades/:upgrade_id
• getListingShippingProfileUpgrades
  • New Name: getShopShippingProfileUpgrades
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/upgrades
• updateListingShippingProfileUpgrade
  • New Name: updateShopShippingProfileUpgrade
  • New Route: /shops/:shop_id/shipping-profiles/:shipping_profile_id/upgrades/:upgrade_id

Shipping Carriers have been moved from the Listings perspective to the Shop perspective.

• getShippingCarriers
  • New Route: /shipping-carriers

The following endpoints are now in beta

• getListingProperties
• getPropertiesByTaxonomyId
• getListingsByListingIds
• getListingsByShopSectionId
• getShopReceiptTransactionsByListing
• getReviewsByShop
• getPaymentAccountLedgerEntryPayments
• getShopPaymentAccountLedgerEntries
• getAllListingFiles
• deleteListingFile
• getListingFile
• getListingImages
• getListingImage
• deleteListingImage
• uploadListingImage
• getListingProduct
• getShopReceiptTransaction
• getSellerTaxonomyNodes
• getShopSection
• updateVariationImages
• getListingVariationImages
• createShopShippingProfile
• createShopShippingProfileDestination
• createShopShippingProfileUpgrade
• deleteShopShippingProfile
• deleteShopShippingProfileDestination
• deleteShopShippingProfileUpgrade
• getListingsByShopReceipt
• getShopShippingProfile
• getShopShippingProfileDestinationsByShippingProfile
• getShopShippingProfiles
• getShopShippingProfileUpgrades
• updateShopShippingProfile
• updateShopShippingProfileUpgrade
• updateShopShippingProfileDestination
• updateListing
• getListingsByShop
• getListing
• createDraftListing
• createReceiptShipment

With this, all our endpoints for the general release are now in Beta!