Changements cl\u00e9s dans l’API Etsy v3 et leur impact sur les vendeurs et les d\u00e9veloppeurs :<\/span><\/h1>\n\n- \n
S\u00e9curit\u00e9 renforc\u00e9e avec OAuth 2.0 :<\/b><\/h2>\n<\/li>\n<\/ol>\n
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\u00e9curis\u00e9e et largement utilis\u00e9e. Il garantit que seules les applications autoris\u00e9es peuvent acc\u00e9der aux donn\u00e9es du vendeur et effectuer des actions en son nom.<\/span><\/p>\n ,war<\/span><\/p>\n\n- <\/b>
\nDemandes de point de terminaison plus claires : <\/b><\/h2>\n<\/li>\n<\/ol>\n
L’API Etsy v3 introduit des changements dans la fa\u00e7on dont les d\u00e9veloppeurs envoient des requ\u00eates \u00e0 l’API. Avec la nouvelle version, chaque demande doit inclure un en-t\u00eate “x-API-key” contenant la cl\u00e9 API de l’application Etsy. Ce changement am\u00e9liore la s\u00e9curit\u00e9 et aide Etsy \u00e0 suivre les demandes d’API plus efficacement. Les vendeurs et les d\u00e9veloppeurs doivent mettre \u00e0 jour leur code pour inclure cet en-t\u00eate lorsqu’ils communiquent avec l’API d’Etsy.<\/span><\/p>\n ,war<\/span><\/p>\n\n- <\/b>
\nParam\u00e8tres de requ\u00eate standard :<\/b><\/h2>\n<\/li>\n<\/ol>\n
La gestion des param\u00e8tres de requ\u00eate standard a \u00e9t\u00e9 modifi\u00e9e. Le param\u00e8tre de requ\u00eate “fields”, pr\u00e9c\u00e9demment utilis\u00e9 pour r\u00e9cup\u00e9rer des ressources partielles en v2, n’est plus support\u00e9 en v3.<\/span>
\n<\/span>Bien que le param\u00e8tre de requ\u00eate “includes” soit toujours disponible dans certains points de terminaison, sa prise en charge est limit\u00e9e. Notamment, certains points de terminaison renvoient d\u00e9sormais par d\u00e9faut les donn\u00e9es de ressources associ\u00e9es, ce qui simplifie l’appel d’API.<\/span><\/p>\n ,war<\/span><\/p>\n\n- \n
Pagination:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Les utilisateurs peuvent d\u00e9sormais d\u00e9couvrir une pagination mise \u00e0 jour. Les param\u00e8tres de requ\u00eate “limit” et “offset” doivent \u00eatre utilis\u00e9s pour la pagination au lieu du param\u00e8tre “page” utilis\u00e9 dans la v2. Les enregistrements par d\u00e9faut renvoy\u00e9s par appel d’API sont de 25 et le nombre maximal d’enregistrements pouvant \u00eatre renvoy\u00e9s est de 100. Pour faciliter la navigation dans des ensembles de donn\u00e9es plus volumineux, Etsy fournit des param\u00e8tres de limite et de d\u00e9calage. Le param\u00e8tre limit permet de sp\u00e9cifier le nombre d’enregistrements \u00e0 r\u00e9cup\u00e9rer par page. Alors que le param\u00e8tre offset vous aide \u00e0 naviguer vers une page de r\u00e9sultats sp\u00e9cifique.<\/span><\/p>\nDe plus, la r\u00e9ponse 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\u00e8tre offset a une valeur maximale de 50000, garantissant une gestion efficace des grands ensembles de donn\u00e9es.<\/span><\/p>\n ,war![\"\u00c9tendues](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/Resource-scopes.png\")
<\/a><\/span><\/p>\n <\/p>\n
\n- \n
\u00c9tendues des ressources :<\/b><\/h2>\n<\/li>\n<\/ol>\n
Dans la mise \u00e0 jour de l’API Etsy v3, les \u00e9tendues de ressources pour filtrer les listes de ressources sont pass\u00e9es de filtres bas\u00e9s sur des chemins \u00e0 des filtres bas\u00e9s sur des param\u00e8tres de requ\u00eate.<\/span><\/p>\nExemple : Filtrage des fiches produits par ID de boutique et \u00e9tat<\/span><\/p>\nSupposons que vous vouliez filtrer les annonces en fonction d’un ID de boutique et d’un \u00e9tat sp\u00e9cifiques. Dans la v2, vous utiliseriez :<\/span><\/p>\n\/v2\/shops\/:shop_id\/listings\/active<\/span><\/p>\nAvec le passage \u00e0 la v3, l’approche des URL et des param\u00e8tres de requ\u00eate serait :<\/span><\/p>\n\/v3\/application\/listings?shop_id=:shop_id&state=active<\/span><\/p>\nIci, vous incluez les valeurs souhait\u00e9es pour l’ID et l’\u00e9tat de la boutique en tant que param\u00e8tres de requ\u00eate.<\/span><\/p>\n ,war<\/span><\/p>\n\n- \n
Structure de r\u00e9ponse am\u00e9lior\u00e9e :<\/b><\/h2>\n<\/li>\n<\/ol>\n
Dans la version pr\u00e9c\u00e9dente du <\/span>API Etsy (v2)<\/span><\/a>, les r\u00e9ponses de l’API suivaient une structure standardis\u00e9e. Encapsulant divers champs et objets imbriqu\u00e9s. Cependant, dans l’API Etsy v3, les r\u00e9ponses ont chang\u00e9. Plus pr\u00e9cis\u00e9ment, les points de terminaison qui renvoient des listes de ressources incluent d\u00e9sormais deux champs importants : “count” et “results”.<\/span><\/p>\nLe champ “count” indique le nombre de r\u00e9sultats dans la r\u00e9ponse, fournissant un aper\u00e7u rapide du nombre total de ressources renvoy\u00e9es. D’autre part, le champ “r\u00e9sultats” contient les objets de ressource r\u00e9els eux-m\u00eames. Cette structure r\u00e9vis\u00e9e permet aux d\u00e9veloppeurs d’acc\u00e9der facilement au d\u00e9compte et de r\u00e9cup\u00e9rer les r\u00e9sultats sp\u00e9cifiques de la r\u00e9ponse.<\/span><\/p>\n ,war<\/span><\/p>\n\n- <\/b>
\nRetrait des ressources obsol\u00e8tes :<\/b><\/h2>\n<\/li>\n<\/ol>\n
Plus de 40 ressources et points de terminaison ont \u00e9t\u00e9 remplac\u00e9s ou supprim\u00e9s dans la v3 dans diverses cat\u00e9gories telles que Paiement. ShopListingVariationImage, ShippingProfileUpgrade, Utilisateur, ShopSection, etc. La liste compl\u00e8te des ressources retir\u00e9es se trouve dans la documentation.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n
\n- \n
Limites de d\u00e9bit API :<\/b><\/h2>\n<\/li>\n<\/ol>\n
![\"La](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/API-Rate-Limits.png\")
<\/a><\/p>\n <\/p>\n
Dans l’API Etsy v3, aucun changement n’a \u00e9t\u00e9 apport\u00e9 aux limites de d\u00e9bit de l’API par rapport \u00e0 la v2. Si vous utilisiez la m\u00eame cl\u00e9 d’API d’application Etsy dans la v2, vos limites tarifaires n\u00e9goci\u00e9es resteront \u00e9galement les m\u00eames dans la v3.<\/span><\/p>\nPar d\u00e9faut, les applications Etsy authentifi\u00e9es avec leur cl\u00e9 API peuvent effectuer jusqu’\u00e0 10,000 24 requ\u00eates publiques sur une p\u00e9riode de 10 heures, offrant aux d\u00e9veloppeurs de nombreuses opportunit\u00e9s d’interagir avec la plateforme Etsy et de r\u00e9cup\u00e9rer les donn\u00e9es n\u00e9cessaires pour leurs applications. La limite de d\u00e9bit (XNUMX requ\u00eates par seconde) garantit une utilisation \u00e9quitable et maintient la stabilit\u00e9 du syst\u00e8me.<\/span><\/p>\n ,war<\/span><\/p>\nSavez-vous?<\/b><\/h2>\n
Avez-vous d\u00e9j\u00e0 une boutique eCommerce bas\u00e9e sur Prestashop, Opencart, WooComemrce ou Magento 2 ? Savez-vous qu’avec le connecteur Knowband Etsy marketplace, vous pouvez lister et g\u00e9rer vos produits sur la marketplace Etsy ?<\/span>
\n<\/span> Le connecteur Knowband Etsy Marketplace est livr\u00e9 avec les derni\u00e8res modifications de l’API Etsy V3 et garantit une int\u00e9gration transparente entre votre site Web et le march\u00e9 Etsy.<\/span>
\n<\/span> Par exemple, vous pouvez g\u00e9rer toutes vos commandes et annonces Etsy directement depuis le panneau d’administration de votre boutique en ligne. De plus, vous pouvez \u00e9galement nous joindre au <\/span>support@knowband.com<\/span><\/a> pour plus d’informations sur Etsy Marketplace Connector.\ufffd<\/span><\/p>\n
S\u00e9curit\u00e9 renforc\u00e9e avec OAuth 2.0 :<\/b><\/h2>\n<\/li>\n<\/ol>\n
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\u00e9curis\u00e9e et largement utilis\u00e9e. Il garantit que seules les applications autoris\u00e9es peuvent acc\u00e9der aux donn\u00e9es du vendeur et effectuer des actions en son nom.<\/span><\/p>\n ,war<\/span><\/p>\n L’API Etsy v3 introduit des changements dans la fa\u00e7on dont les d\u00e9veloppeurs envoient des requ\u00eates \u00e0 l’API. Avec la nouvelle version, chaque demande doit inclure un en-t\u00eate “x-API-key” contenant la cl\u00e9 API de l’application Etsy. Ce changement am\u00e9liore la s\u00e9curit\u00e9 et aide Etsy \u00e0 suivre les demandes d’API plus efficacement. Les vendeurs et les d\u00e9veloppeurs doivent mettre \u00e0 jour leur code pour inclure cet en-t\u00eate lorsqu’ils communiquent avec l’API d’Etsy.<\/span><\/p>\n ,war<\/span><\/p>\n La gestion des param\u00e8tres de requ\u00eate standard a \u00e9t\u00e9 modifi\u00e9e. Le param\u00e8tre de requ\u00eate “fields”, pr\u00e9c\u00e9demment utilis\u00e9 pour r\u00e9cup\u00e9rer des ressources partielles en v2, n’est plus support\u00e9 en v3.<\/span> ,war<\/span><\/p>\n Les utilisateurs peuvent d\u00e9sormais d\u00e9couvrir une pagination mise \u00e0 jour. Les param\u00e8tres de requ\u00eate “limit” et “offset” doivent \u00eatre utilis\u00e9s pour la pagination au lieu du param\u00e8tre “page” utilis\u00e9 dans la v2. Les enregistrements par d\u00e9faut renvoy\u00e9s par appel d’API sont de 25 et le nombre maximal d’enregistrements pouvant \u00eatre renvoy\u00e9s est de 100. Pour faciliter la navigation dans des ensembles de donn\u00e9es plus volumineux, Etsy fournit des param\u00e8tres de limite et de d\u00e9calage. Le param\u00e8tre limit permet de sp\u00e9cifier le nombre d’enregistrements \u00e0 r\u00e9cup\u00e9rer par page. Alors que le param\u00e8tre offset vous aide \u00e0 naviguer vers une page de r\u00e9sultats sp\u00e9cifique.<\/span><\/p>\n De plus, la r\u00e9ponse 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\u00e8tre offset a une valeur maximale de 50000, garantissant une gestion efficace des grands ensembles de donn\u00e9es.<\/span><\/p>\n ,war <\/p>\n Dans la mise \u00e0 jour de l’API Etsy v3, les \u00e9tendues de ressources pour filtrer les listes de ressources sont pass\u00e9es de filtres bas\u00e9s sur des chemins \u00e0 des filtres bas\u00e9s sur des param\u00e8tres de requ\u00eate.<\/span><\/p>\n Exemple : Filtrage des fiches produits par ID de boutique et \u00e9tat<\/span><\/p>\n Supposons que vous vouliez filtrer les annonces en fonction d’un ID de boutique et d’un \u00e9tat sp\u00e9cifiques. Dans la v2, vous utiliseriez :<\/span><\/p>\n \/v2\/shops\/:shop_id\/listings\/active<\/span><\/p>\n Avec le passage \u00e0 la v3, l’approche des URL et des param\u00e8tres de requ\u00eate serait :<\/span><\/p>\n \/v3\/application\/listings?shop_id=:shop_id&state=active<\/span><\/p>\n Ici, vous incluez les valeurs souhait\u00e9es pour l’ID et l’\u00e9tat de la boutique en tant que param\u00e8tres de requ\u00eate.<\/span><\/p>\n ,war<\/span><\/p>\n Dans la version pr\u00e9c\u00e9dente du <\/span>API Etsy (v2)<\/span><\/a>, les r\u00e9ponses de l’API suivaient une structure standardis\u00e9e. Encapsulant divers champs et objets imbriqu\u00e9s. Cependant, dans l’API Etsy v3, les r\u00e9ponses ont chang\u00e9. Plus pr\u00e9cis\u00e9ment, les points de terminaison qui renvoient des listes de ressources incluent d\u00e9sormais deux champs importants : “count” et “results”.<\/span><\/p>\n Le champ “count” indique le nombre de r\u00e9sultats dans la r\u00e9ponse, fournissant un aper\u00e7u rapide du nombre total de ressources renvoy\u00e9es. D’autre part, le champ “r\u00e9sultats” contient les objets de ressource r\u00e9els eux-m\u00eames. Cette structure r\u00e9vis\u00e9e permet aux d\u00e9veloppeurs d’acc\u00e9der facilement au d\u00e9compte et de r\u00e9cup\u00e9rer les r\u00e9sultats sp\u00e9cifiques de la r\u00e9ponse.<\/span><\/p>\n ,war<\/span><\/p>\n Plus de 40 ressources et points de terminaison ont \u00e9t\u00e9 remplac\u00e9s ou supprim\u00e9s dans la v3 dans diverses cat\u00e9gories telles que Paiement. ShopListingVariationImage, ShippingProfileUpgrade, Utilisateur, ShopSection, etc. La liste compl\u00e8te des ressources retir\u00e9es se trouve dans la documentation.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n <\/p>\n Dans l’API Etsy v3, aucun changement n’a \u00e9t\u00e9 apport\u00e9 aux limites de d\u00e9bit de l’API par rapport \u00e0 la v2. Si vous utilisiez la m\u00eame cl\u00e9 d’API d’application Etsy dans la v2, vos limites tarifaires n\u00e9goci\u00e9es resteront \u00e9galement les m\u00eames dans la v3.<\/span><\/p>\n Par d\u00e9faut, les applications Etsy authentifi\u00e9es avec leur cl\u00e9 API peuvent effectuer jusqu’\u00e0 10,000 24 requ\u00eates publiques sur une p\u00e9riode de 10 heures, offrant aux d\u00e9veloppeurs de nombreuses opportunit\u00e9s d’interagir avec la plateforme Etsy et de r\u00e9cup\u00e9rer les donn\u00e9es n\u00e9cessaires pour leurs applications. La limite de d\u00e9bit (XNUMX requ\u00eates par seconde) garantit une utilisation \u00e9quitable et maintient la stabilit\u00e9 du syst\u00e8me.<\/span><\/p>\n ,war<\/span><\/p>\n Avez-vous d\u00e9j\u00e0 une boutique eCommerce bas\u00e9e sur Prestashop, Opencart, WooComemrce ou Magento 2 ? Savez-vous qu’avec le connecteur Knowband Etsy marketplace, vous pouvez lister et g\u00e9rer vos produits sur la marketplace Etsy ?<\/span>\n
\nDemandes de point de terminaison plus claires : <\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nParam\u00e8tres de requ\u00eate standard :<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n<\/span>Bien que le param\u00e8tre de requ\u00eate “includes” soit toujours disponible dans certains points de terminaison, sa prise en charge est limit\u00e9e. Notamment, certains points de terminaison renvoient d\u00e9sormais par d\u00e9faut les donn\u00e9es de ressources associ\u00e9es, ce qui simplifie l’appel d’API.<\/span><\/p>\n\n
Pagination:<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/span><\/p>\n\n
\u00c9tendues des ressources :<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
Structure de r\u00e9ponse am\u00e9lior\u00e9e :<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nRetrait des ressources obsol\u00e8tes :<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
Limites de d\u00e9bit API :<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/p>\nSavez-vous?<\/b><\/h2>\n
\n<\/span> Le connecteur Knowband Etsy Marketplace est livr\u00e9 avec les derni\u00e8res modifications de l’API Etsy V3 et garantit une int\u00e9gration transparente entre votre site Web et le march\u00e9 Etsy.<\/span>
\n<\/span> Par exemple, vous pouvez g\u00e9rer toutes vos commandes et annonces Etsy directement depuis le panneau d’administration de votre boutique en ligne. De plus, vous pouvez \u00e9galement nous joindre au <\/span>support@knowband.com<\/span><\/a> pour plus d’informations sur Etsy Marketplace Connector.\ufffd<\/span><\/p>\n