Cambios clave en la API v3 de Etsy y c\u00f3mo afectan a los vendedores y desarrolladores:<\/span><\/h1>\n\n- \n
Seguridad mejorada con OAuth 2.0:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Uno de los cambios importantes en Etsy API v3 es la adopci\u00f3n de OAuth 2.0 para autenticaci\u00f3n y autorizaci\u00f3n. OAuth 2.0 es un est\u00e1ndar industrial m\u00e1s seguro y ampliamente utilizado. Garantiza que solo las aplicaciones autorizadas puedan acceder a los datos del vendedor y realizar acciones en su nombre.\ufffd<\/span><\/p>\n <\/span><\/p>\n\n- <\/b>
\nSolicitudes de terminales m\u00e1s claras:\ufffd<\/b><\/h2>\n<\/li>\n<\/ol>\n
Etsy API v3 introduce cambios en la forma en que los desarrolladores realizan solicitudes a la API. Con la nueva versi\u00f3n, cada solicitud debe incluir un encabezado “x-API-key” que contenga la clave API de la aplicaci\u00f3n de Etsy. Este cambio mejora la seguridad y ayuda a Etsy a realizar un seguimiento de las solicitudes de API de forma m\u00e1s eficaz. Los vendedores y desarrolladores deben actualizar su c\u00f3digo para incluir este encabezado cuando se comuniquen con la API de Etsy.<\/span><\/p>\n <\/span><\/p>\n\n- <\/b>
\nPar\u00e1metros de solicitud est\u00e1ndar:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Se ha modificado el manejo de los par\u00e1metros de solicitud est\u00e1ndar. El par\u00e1metro de consulta “campos”, que se usaba anteriormente para recuperar recursos parciales en v2, ya no se admite en v3.<\/span>
\n<\/span>Si bien el par\u00e1metro de consulta “incluye” todav\u00eda est\u00e1 disponible en algunos puntos finales, su compatibilidad es limitada. En particular, algunos puntos finales ahora devuelven datos de recursos asociados de forma predeterminada, lo que simplifica la llamada a la API.<\/span><\/p>\n <\/span><\/p>\n\n- \n
Paginaci\u00f3n:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Los usuarios ahora pueden experimentar la paginaci\u00f3n actualizada. Los par\u00e1metros de consulta “l\u00edmite” y “desplazamiento” deben usarse para la paginaci\u00f3n en lugar del par\u00e1metro “p\u00e1gina” que se usa en v2. Los registros predeterminados que se devuelven por llamada a la API son 25 y el n\u00famero m\u00e1ximo de registros que se pueden devolver es 100. Para facilitar la navegaci\u00f3n a trav\u00e9s de conjuntos de datos m\u00e1s grandes, Etsy proporciona par\u00e1metros de l\u00edmite y compensaci\u00f3n. El par\u00e1metro de l\u00edmite le permite especificar el n\u00famero de registros para recuperar por p\u00e1gina. Mientras que el par\u00e1metro de desplazamiento lo ayuda a navegar a una p\u00e1gina espec\u00edfica de resultados.<\/span><\/p>\nAdem\u00e1s, la respuesta incluye un campo de recuento, que indica el n\u00famero total de registros disponibles para la paginaci\u00f3n. Tenga en cuenta que, por razones de rendimiento, el par\u00e1metro de compensaci\u00f3n tiene un valor m\u00e1ximo de 50000, lo que garantiza un manejo eficiente de grandes conjuntos de datos.<\/span><\/p>\n ![\"\u00c1mbitos](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/Resource-scopes.png\")
<\/a><\/span><\/p>\n <\/p>\n
\n- \n
\u00c1mbitos de recursos:<\/b><\/h2>\n<\/li>\n<\/ol>\n
En la Etsy API v3 actualizada, los \u00e1mbitos de recursos para filtrar listas de recursos han pasado de filtros basados \u200b\u200ben rutas a filtros basados \u200b\u200ben par\u00e1metros de consulta.<\/span><\/p>\nEjemplo: filtrado de listados por ID de tienda y estado<\/span><\/p>\nSupongamos que desea filtrar los listados por ID de tienda y estado espec\u00edficos. En v2, usar\u00eda:<\/span><\/p>\n\/v2\/tiendas\/:shop_id\/listings\/active<\/span><\/p>\nCon el cambio a v3, el enfoque de URL y par\u00e1metro de consulta ser\u00eda:<\/span><\/p>\n\/v3\/aplicaci\u00f3n\/listados?shop_id=:shop_id&state=activo<\/span><\/p>\nAqu\u00ed, incluye los valores deseados para el ID de la tienda y el estado como par\u00e1metros de consulta.<\/span><\/p>\n <\/span><\/p>\n\n- \n
Estructura de respuesta mejorada:<\/b><\/h2>\n<\/li>\n<\/ol>\n
En la versi\u00f3n anterior del <\/span>API de Etsy (v2)<\/span><\/a>, las respuestas de la API siguieron una estructura estandarizada. Encapsular varios campos y objetos anidados. Sin embargo, en Etsy API v3, las respuestas han cambiado. Espec\u00edficamente, los puntos finales que devuelven listas de recursos ahora incluyen dos campos importantes: “recuento” y “resultados”.<\/span><\/p>\nEl campo “recuento” indica el n\u00famero de resultados en la respuesta, lo que proporciona una descripci\u00f3n general r\u00e1pida del recuento total de recursos devueltos. Por otro lado, el campo “resultados” contiene los propios objetos de recursos reales. Esta estructura revisada permite a los desarrolladores acceder f\u00e1cilmente al conteo y recuperar los resultados espec\u00edficos de la respuesta.<\/span><\/p>\n <\/span><\/p>\n\n- <\/b>
\nRetiro de Recursos Obsoletos:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Se reemplazaron o eliminaron m\u00e1s de 40 recursos y puntos finales en v3 en varias categor\u00edas, como Pago. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection y m\u00e1s. La lista completa de recursos retirados se puede encontrar en la documentaci\u00f3n.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n
\n- \n
L\u00edmites de tasa de API:<\/b><\/h2>\n<\/li>\n<\/ol>\n
![\"El](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/API-Rate-Limits.png\")
<\/a><\/p>\n <\/p>\n
En Etsy API v3, no ha habido cambios en los l\u00edmites de velocidad de la API en comparaci\u00f3n con v2. Si estabas usando la misma clave API de la aplicaci\u00f3n de Etsy en v2, tus l\u00edmites de tarifas negociados seguir\u00e1n siendo los mismos en v3 tambi\u00e9n.<\/span><\/p>\nDe forma predeterminada, las aplicaciones de Etsy autenticadas con su clave API pueden realizar hasta 10,000 24 solicitudes p\u00fablicas en un per\u00edodo de 10 horas, lo que brinda a los desarrolladores amplias oportunidades para interactuar con la plataforma de Etsy y recuperar los datos necesarios para sus aplicaciones. El l\u00edmite de frecuencia (XNUMX consultas por segundo) garantiza un uso justo y mantiene la estabilidad del sistema.<\/span><\/p>\n <\/span><\/p>\n\u00bfSabes T\u00fa?<\/b><\/h2>\n
\u00bfYa tiene una tienda de comercio electr\u00f3nico basada en Prestashop, Opencart, WooComemrce o Magento 2? \u00bfSabe que con el conector del mercado de Etsy de Knowband, puede enumerar y administrar sus productos en el mercado de Etsy?<\/span>
\n<\/span> El conector Knowband Etsy Marketplace viene con los \u00faltimos cambios de la API de Etsy V3 y garantiza una integraci\u00f3n perfecta entre su sitio web y el mercado de Etsy.<\/span>
\n<\/span> Por ejemplo, puede administrar todos sus pedidos y listados de Etsy directamente desde el panel de administraci\u00f3n de su tienda de comercio electr\u00f3nico. Adem\u00e1s, tambi\u00e9n puede comunicarse con nosotros en <\/span>support@knowband.com<\/span><\/a> para obtener m\u00e1s informaci\u00f3n sobre Etsy Marketplace Connector.\ufffd<\/span><\/p>\n
Seguridad mejorada con OAuth 2.0:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Uno de los cambios importantes en Etsy API v3 es la adopci\u00f3n de OAuth 2.0 para autenticaci\u00f3n y autorizaci\u00f3n. OAuth 2.0 es un est\u00e1ndar industrial m\u00e1s seguro y ampliamente utilizado. Garantiza que solo las aplicaciones autorizadas puedan acceder a los datos del vendedor y realizar acciones en su nombre.\ufffd<\/span><\/p>\n <\/span><\/p>\n Etsy API v3 introduce cambios en la forma en que los desarrolladores realizan solicitudes a la API. Con la nueva versi\u00f3n, cada solicitud debe incluir un encabezado “x-API-key” que contenga la clave API de la aplicaci\u00f3n de Etsy. Este cambio mejora la seguridad y ayuda a Etsy a realizar un seguimiento de las solicitudes de API de forma m\u00e1s eficaz. Los vendedores y desarrolladores deben actualizar su c\u00f3digo para incluir este encabezado cuando se comuniquen con la API de Etsy.<\/span><\/p>\n <\/span><\/p>\n Se ha modificado el manejo de los par\u00e1metros de solicitud est\u00e1ndar. El par\u00e1metro de consulta “campos”, que se usaba anteriormente para recuperar recursos parciales en v2, ya no se admite en v3.<\/span> <\/span><\/p>\n Los usuarios ahora pueden experimentar la paginaci\u00f3n actualizada. Los par\u00e1metros de consulta “l\u00edmite” y “desplazamiento” deben usarse para la paginaci\u00f3n en lugar del par\u00e1metro “p\u00e1gina” que se usa en v2. Los registros predeterminados que se devuelven por llamada a la API son 25 y el n\u00famero m\u00e1ximo de registros que se pueden devolver es 100. Para facilitar la navegaci\u00f3n a trav\u00e9s de conjuntos de datos m\u00e1s grandes, Etsy proporciona par\u00e1metros de l\u00edmite y compensaci\u00f3n. El par\u00e1metro de l\u00edmite le permite especificar el n\u00famero de registros para recuperar por p\u00e1gina. Mientras que el par\u00e1metro de desplazamiento lo ayuda a navegar a una p\u00e1gina espec\u00edfica de resultados.<\/span><\/p>\n Adem\u00e1s, la respuesta incluye un campo de recuento, que indica el n\u00famero total de registros disponibles para la paginaci\u00f3n. Tenga en cuenta que, por razones de rendimiento, el par\u00e1metro de compensaci\u00f3n tiene un valor m\u00e1ximo de 50000, lo que garantiza un manejo eficiente de grandes conjuntos de datos.<\/span><\/p>\n <\/p>\n En la Etsy API v3 actualizada, los \u00e1mbitos de recursos para filtrar listas de recursos han pasado de filtros basados \u200b\u200ben rutas a filtros basados \u200b\u200ben par\u00e1metros de consulta.<\/span><\/p>\n Ejemplo: filtrado de listados por ID de tienda y estado<\/span><\/p>\n Supongamos que desea filtrar los listados por ID de tienda y estado espec\u00edficos. En v2, usar\u00eda:<\/span><\/p>\n \/v2\/tiendas\/:shop_id\/listings\/active<\/span><\/p>\n Con el cambio a v3, el enfoque de URL y par\u00e1metro de consulta ser\u00eda:<\/span><\/p>\n \/v3\/aplicaci\u00f3n\/listados?shop_id=:shop_id&state=activo<\/span><\/p>\n Aqu\u00ed, incluye los valores deseados para el ID de la tienda y el estado como par\u00e1metros de consulta.<\/span><\/p>\n <\/span><\/p>\n En la versi\u00f3n anterior del <\/span>API de Etsy (v2)<\/span><\/a>, las respuestas de la API siguieron una estructura estandarizada. Encapsular varios campos y objetos anidados. Sin embargo, en Etsy API v3, las respuestas han cambiado. Espec\u00edficamente, los puntos finales que devuelven listas de recursos ahora incluyen dos campos importantes: “recuento” y “resultados”.<\/span><\/p>\n El campo “recuento” indica el n\u00famero de resultados en la respuesta, lo que proporciona una descripci\u00f3n general r\u00e1pida del recuento total de recursos devueltos. Por otro lado, el campo “resultados” contiene los propios objetos de recursos reales. Esta estructura revisada permite a los desarrolladores acceder f\u00e1cilmente al conteo y recuperar los resultados espec\u00edficos de la respuesta.<\/span><\/p>\n <\/span><\/p>\n Se reemplazaron o eliminaron m\u00e1s de 40 recursos y puntos finales en v3 en varias categor\u00edas, como Pago. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection y m\u00e1s. La lista completa de recursos retirados se puede encontrar en la documentaci\u00f3n.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n <\/p>\n En Etsy API v3, no ha habido cambios en los l\u00edmites de velocidad de la API en comparaci\u00f3n con v2. Si estabas usando la misma clave API de la aplicaci\u00f3n de Etsy en v2, tus l\u00edmites de tarifas negociados seguir\u00e1n siendo los mismos en v3 tambi\u00e9n.<\/span><\/p>\n De forma predeterminada, las aplicaciones de Etsy autenticadas con su clave API pueden realizar hasta 10,000 24 solicitudes p\u00fablicas en un per\u00edodo de 10 horas, lo que brinda a los desarrolladores amplias oportunidades para interactuar con la plataforma de Etsy y recuperar los datos necesarios para sus aplicaciones. El l\u00edmite de frecuencia (XNUMX consultas por segundo) garantiza un uso justo y mantiene la estabilidad del sistema.<\/span><\/p>\n <\/span><\/p>\n \u00bfYa tiene una tienda de comercio electr\u00f3nico basada en Prestashop, Opencart, WooComemrce o Magento 2? \u00bfSabe que con el conector del mercado de Etsy de Knowband, puede enumerar y administrar sus productos en el mercado de Etsy?<\/span>\n
\nSolicitudes de terminales m\u00e1s claras:\ufffd<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nPar\u00e1metros de solicitud est\u00e1ndar:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n<\/span>Si bien el par\u00e1metro de consulta “incluye” todav\u00eda est\u00e1 disponible en algunos puntos finales, su compatibilidad es limitada. En particular, algunos puntos finales ahora devuelven datos de recursos asociados de forma predeterminada, lo que simplifica la llamada a la API.<\/span><\/p>\n\n
Paginaci\u00f3n:<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/span><\/p>\n\n
\u00c1mbitos de recursos:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
Estructura de respuesta mejorada:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nRetiro de Recursos Obsoletos:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
L\u00edmites de tasa de API:<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/p>\n\u00bfSabes T\u00fa?<\/b><\/h2>\n
\n<\/span> El conector Knowband Etsy Marketplace viene con los \u00faltimos cambios de la API de Etsy V3 y garantiza una integraci\u00f3n perfecta entre su sitio web y el mercado de Etsy.<\/span>
\n<\/span> Por ejemplo, puede administrar todos sus pedidos y listados de Etsy directamente desde el panel de administraci\u00f3n de su tienda de comercio electr\u00f3nico. Adem\u00e1s, tambi\u00e9n puede comunicarse con nosotros en <\/span>support@knowband.com<\/span><\/a> para obtener m\u00e1s informaci\u00f3n sobre Etsy Marketplace Connector.\ufffd<\/span><\/p>\n