Okapi Okapi

Etsy Open API /v2/* version retirement

Stopped workingSubscribe to Etsy Open APIShare

On April 3, 2023, Open API v2 was turned off. This retirement affected all calls to /v2/* endpoints. After this date, any requests sent to these endpoints fail.


Calls it hits

  • /v2/*

What to use instead of these calls

Use Open API v3 (/v3/application/...) with OAuth 2.0 tokens and an x-api-key header. The transition requires more than updating an identifier, as Open API v3 uses different endpoints and requires new OAuth 2.0 authorization from every connected shop.

Open API v3 has other endpoints and needs OAuth 2.0 authorization from every connected shop again.

In Etsy Open API's words

As of Monday, April 3, 2023 v2 will be turned off and any requests to v2 endpoints will fail.

Etsy Open API, Announcement

Facts

API
Etsy Open API openapi.etsy.com
Kind
Version retirement
Takes effect
April 3, 2023
Calls after that day
Fail
Source
Announcement
Last updated
Verified
, against Etsy Open API's own pages

Questions

When does this change take effect?

Calls to /v2/* on Etsy Open API stopped working on April 3, 2023.

What happens to calls after April 3, 2023?

They have failed since April 3, 2023.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from Etsy Open API 4

  1. GET /v3/application/shops/{id}/listings/{id}/imagesEndpoint removal Stopped working
  2. GET /v3/application/shops/{id}/listings/{id}/images/{id}Endpoint removal Stopped working
  3. PUT /v3/application/shops/{id}/listings/{id}Endpoint removal Stopped working
  4. POST /v3/application/shops/{id}/listings/{id}/videosBehaviour change Stopped working

You fixed this one by hand.

Okapi opens the pull request with the fix before the next breaking change reaches your code.

Add to GitHub

Get notifications

Subscribe to Etsy Open API

Hear about each breaking change Etsy Open API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • Etsy Open API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.