Knowband Blog | Ecommerce Modules

Exploring the Changes in Etsy API v3

Etsy, le marché en ligne populaire, a présenté sa dernière version d’API, Etsy API v3, remplaçant l’ancienne version v2. Cette transition apporte des changements et des améliorations importants dont les vendeurs et les développeurs doivent être conscients pour assurer un processus d’intégration fluide. Dans cet article, nous allons explorer les principaux changements dans API Etsy v3 en termes simples, vous aidant à comprendre et à vous adapter à ces mises à jour.

Changements clés dans l’API Etsy v3 et leur impact sur les vendeurs et les développeurs :

  1. Sécurité renforcée avec OAuth 2.0 :

L’un des changements importants dans l’API Etsy v3 est l’adoption d’OAuth 2.0 pour l’authentification et l’autorisation. OAuth 2.0 est une norme industrielle plus sécurisée et largement utilisée. Il garantit que seules les applications autorisées peuvent accéder aux données du vendeur et effectuer des actions en son nom.

,war


  1. Demandes de point de terminaison plus claires : 

L’API Etsy v3 introduit des changements dans la façon dont les développeurs envoient des requêtes à l’API. Avec la nouvelle version, chaque demande doit inclure un en-tête “x-API-key” contenant la clé API de l’application Etsy. Ce changement améliore la sécurité et aide Etsy à suivre les demandes d’API plus efficacement. Les vendeurs et les développeurs doivent mettre à jour leur code pour inclure cet en-tête lorsqu’ils communiquent avec l’API d’Etsy.

,war


  1. Paramètres de requête standard :

La gestion des paramètres de requête standard a été modifiée. Le paramètre de requête “fields”, précédemment utilisé pour récupérer des ressources partielles en v2, n’est plus supporté en v3.
Bien que le paramètre de requête “includes” soit toujours disponible dans certains points de terminaison, sa prise en charge est limitée. Notamment, certains points de terminaison renvoient désormais par défaut les données de ressources associées, ce qui simplifie l’appel d’API.

,war

  1. Pagination:

Les utilisateurs peuvent désormais découvrir une pagination mise à jour. Les paramètres de requête “limit” et “offset” doivent être utilisés pour la pagination au lieu du paramètre “page” utilisé dans la v2. Les enregistrements par défaut renvoyés par appel d’API sont de 25 et le nombre maximal d’enregistrements pouvant être renvoyés est de 100. Pour faciliter la navigation dans des ensembles de données plus volumineux, Etsy fournit des paramètres de limite et de décalage. Le paramètre limit permet de spécifier le nombre d’enregistrements à récupérer par page. Alors que le paramètre offset vous aide à naviguer vers une page de résultats spécifique.

De plus, la réponse inclut un champ de comptage, indiquant le nombre total d’enregistrements disponibles pour la pagination. Veuillez noter que pour des raisons de performances, le paramètre offset a une valeur maximale de 50000, garantissant une gestion efficace des grands ensembles de données.

,war

 

  1. Étendues des ressources :

Dans la mise à jour de l’API Etsy v3, les étendues de ressources pour filtrer les listes de ressources sont passées de filtres basés sur des chemins à des filtres basés sur des paramètres de requête.

Exemple : Filtrage des fiches produits par ID de boutique et état

Supposons que vous vouliez filtrer les annonces en fonction d’un ID de boutique et d’un état spécifiques. Dans la v2, vous utiliseriez :

/v2/shops/:shop_id/listings/active

Avec le passage à la v3, l’approche des URL et des paramètres de requête serait :

/v3/application/listings?shop_id=:shop_id&state=active

Ici, vous incluez les valeurs souhaitées pour l’ID et l’état de la boutique en tant que paramètres de requête.

,war

  1. Structure de réponse améliorée :

Dans la version précédente du API Etsy (v2), les réponses de l’API suivaient une structure standardisée. Encapsulant divers champs et objets imbriqués. Cependant, dans l’API Etsy v3, les réponses ont changé. Plus précisément, les points de terminaison qui renvoient des listes de ressources incluent désormais deux champs importants : “count” et “results”.

Le champ “count” indique le nombre de résultats dans la réponse, fournissant un aperçu rapide du nombre total de ressources renvoyées. D’autre part, le champ “résultats” contient les objets de ressource réels eux-mêmes. Cette structure révisée permet aux développeurs d’accéder facilement au décompte et de récupérer les résultats spécifiques de la réponse.

,war


  1. Retrait des ressources obsolètes :

Plus de 40 ressources et points de terminaison ont été remplacés ou supprimés dans la v3 dans diverses catégories telles que Paiement. ShopListingVariationImage, ShippingProfileUpgrade, Utilisateur, ShopSection, etc. La liste complète des ressources retirées se trouve dans la documentation.>>https://developers.etsy.com/documentation/migration/retired-resources/

 

  1. Limites de débit API :

 

Dans l’API Etsy v3, aucun changement n’a été apporté aux limites de débit de l’API par rapport à la v2. Si vous utilisiez la même clé d’API d’application Etsy dans la v2, vos limites tarifaires négociées resteront également les mêmes dans la v3.

Par défaut, les applications Etsy authentifiées avec leur clé API peuvent effectuer jusqu’à 10,000 24 requêtes publiques sur une période de 10 heures, offrant aux développeurs de nombreuses opportunités d’interagir avec la plateforme Etsy et de récupérer les données nécessaires pour leurs applications. La limite de débit (XNUMX requêtes par seconde) garantit une utilisation équitable et maintient la stabilité du système.

,war

Savez-vous?

Avez-vous déjà une boutique eCommerce basée sur Prestashop, Opencart, WooComemrce ou Magento 2 ? Savez-vous qu’avec le connecteur Knowband Etsy marketplace, vous pouvez lister et gérer vos produits sur la marketplace Etsy ?
Le connecteur Knowband Etsy Marketplace est livré avec les dernières modifications de l’API Etsy V3 et garantit une intégration transparente entre votre site Web et le marché Etsy.
Par exemple, vous pouvez gérer toutes vos commandes et annonces Etsy directement depuis le panneau d’administration de votre boutique en ligne. De plus, vous pouvez également nous joindre au support@knowband.com pour plus d’informations sur Etsy Marketplace Connector.�

,war

Conclusion:

La transition vers l’API Etsy v3 apporte des changements importants visant à renforcer la sécurité, à simplifier l’intégration et à améliorer l’expérience globale des vendeurs et des développeurs. En comprenant et en vous adaptant à ces changements, vous pouvez assurer une intégration avec la version API mise à jour d’Etsy et exploiter efficacement ses nouvelles capacités.

,war