Wichtige Änderungen in der Etsy-API v3 und wie sie sich auf Verkäufer und Entwickler auswirken:
Eine der wichtigen Änderungen in Etsy API v3 ist die Einführung von OAuth 2.0 zur Authentifizierung und Autorisierung. OAuth 2.0 ist ein sicherer und weit verbreiteter Industriestandard. Es stellt sicher, dass nur autorisierte Anwendungen auf Verkäuferdaten zugreifen und in ihrem Namen Aktionen durchführen können.�
,war
Etsy API v3 führt Änderungen an der Art und Weise ein, wie Entwickler Anfragen an die API stellen. Mit der neuen Version muss jede Anfrage einen „x-API-key“-Header enthalten, der den Etsy-App-API-Schlüssel enthält. Diese Änderung erhöht die Sicherheit und hilft Etsy dabei, API-Anfragen effektiver zu verfolgen. Verkäufer und Entwickler müssen ihren Code aktualisieren, um diesen Header einzuschließen, wenn sie mit Etsys API kommunizieren.
,war
Die Behandlung von Standard-Anfrageparametern wurde geändert. Der Abfrageparameter „fields“, der zuvor in Version 2 zum Abrufen von Teilressourcen verwendet wurde, wird in Version 3 nicht mehr unterstützt.
Während der Abfrageparameter „includes“ auf einigen Endpunkten weiterhin verfügbar ist, ist seine Unterstützung begrenzt. Bemerkenswert ist, dass einige Endpunkte jetzt standardmäßig zugehörige Ressourcendaten zurückgeben, was den API-Aufruf vereinfacht.
,war
Die Benutzer können jetzt eine aktualisierte Paginierung erleben. Für die Paginierung sollten die Abfrageparameter „limit“ und „offset“ anstelle des in Version 2 verwendeten Parameters „page“ verwendet werden. Pro API-Aufruf werden standardmäßig 25 Datensätze zurückgegeben, und die maximale Anzahl der zurückgegebenen Datensätze beträgt 100. Um die Navigation durch größere Datensätze zu erleichtern, stellt Etsy Grenzwert- und Offset-Parameter bereit. Mit dem Parameter „Limit“ können Sie die Anzahl der pro Seite abzurufenden Datensätze angeben. Der Offset-Parameter hilft Ihnen dabei, zu einer bestimmten Ergebnisseite zu navigieren.
Darüber hinaus enthält die Antwort ein Zählfeld, das die Gesamtzahl der für die Paginierung verfügbaren Datensätze angibt. Bitte beachten Sie, dass der Offset-Parameter aus Leistungsgründen einen Maximalwert von 50000 hat, um eine effiziente Verarbeitung großer Datenmengen zu gewährleisten.
,war
In der aktualisierten Etsy-API v3 wurden die Ressourcenbereiche zum Filtern von Ressourcenlisten von pfadbasierten auf abfrageparameterbasierte Filter umgestellt.
Beispiel: Einträge nach Shop-ID und Bundesland filtern
Angenommen, Sie möchten Einträge nach einer bestimmten Shop-ID und einem bestimmten Bundesland filtern. In Version 2 würden Sie Folgendes verwenden:
/v2/shops/:shop_id/listings/active
Mit der Umstellung auf Version 3 wäre der URL- und Abfrageparameter-Ansatz wie folgt:
/v3/application/listings?shop_id=:shop_id&state=active
Hier geben Sie als Abfrageparameter die gewünschten Werte für Shop-ID und Bundesland ein.
,war
In der vorherigen Version des Etsy-API (v2), API-Antworten folgten einer standardisierten Struktur. Kapselung verschiedener Felder und verschachtelter Objekte. In Etsy API v3 haben sich die Antworten jedoch geändert. Insbesondere Endpunkte, die Ressourcenlisten zurückgeben, enthalten jetzt zwei wichtige Felder: „Anzahl“ und „Ergebnisse“.
Das Feld „Anzahl“ gibt die Anzahl der Ergebnisse in der Antwort an und bietet einen schnellen Überblick über die Gesamtzahl der zurückgegebenen Ressourcen. Andererseits enthält das Feld „Ergebnisse“ die eigentlichen Ressourcenobjekte selbst. Diese überarbeitete Struktur ermöglicht es Entwicklern, einfach auf die Zählung zuzugreifen und die spezifischen Ergebnisse aus der Antwort abzurufen.
,war
Über 40 Ressourcen und Endpunkte wurden in Version 3 in verschiedenen Kategorien wie Zahlungen ersetzt oder entfernt. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection und mehr. Die vollständige Liste der ausgemusterten Ressourcen finden Sie in der Dokumentation.>>https://developers.etsy.com/documentation/migration/retired-resources/
In Etsy API v3 gab es im Vergleich zu v2 keine Änderungen an den API-Ratenbegrenzungen. Wenn Sie in Version 2 denselben Etsy-App-API-Schlüssel verwendet haben, bleiben Ihre ausgehandelten Ratenlimits auch in Version 3 gleich.
Standardmäßig können mit ihrem API-Schlüssel authentifizierte Etsy-Apps innerhalb von 10,000 Stunden bis zu 24 öffentliche Anfragen stellen, was Entwicklern zahlreiche Möglichkeiten bietet, mit der Etsy-Plattform zu interagieren und die notwendigen Daten für ihre Anwendungen abzurufen. Die Ratenbegrenzung (10 Abfragen pro Sekunde) gewährleistet eine faire Nutzung und erhält die Systemstabilität.
,war
Wissen Sie?
Haben Sie bereits einen auf Prestashop, Opencart, WooComemrce oder Magento 2 basierenden E-Commerce-Shop? Wussten Sie, dass Sie mit dem Etsy-Marktplatz-Connector von Knowband Ihre Produkte auf dem Etsy-Marktplatz auflisten und verwalten können?
Der Knowband Etsy Marketplace-Connector enthält die neuesten Änderungen an der Etsy V3-API und gewährleistet eine nahtlose Integration zwischen Ihrer Website und dem Etsy-Marktplatz.
Sie können beispielsweise alle Ihre Etsy-Bestellungen und -Angebote direkt über das Admin-Panel Ihres E-Commerce-Shops verwalten. Darüber hinaus können Sie uns auch unter erreichen support@knowband.com Weitere Informationen zum Etsy Marketplace Connector finden Sie hier
,war
Fazit:
Der Übergang zur Etsy API v3 bringt wichtige Änderungen mit sich, die darauf abzielen, die Sicherheit zu erhöhen, die Integration zu vereinfachen und das Gesamterlebnis für Verkäufer und Entwickler zu verbessern. Wenn Sie diese Veränderungen verstehen und sich an sie anpassen, können Sie eine reibungslose Abwicklung gewährleisten Integration mit Etsys aktualisierter API-Version und die neuen Fähigkeiten effektiv nutzen.
,war
