Knowband Blog | Ecommerce Modules

Exploring the Changes in Etsy API v3

Etsy, el popular mercado en línea, ha presentado su última versión de API, Etsy API v3, que reemplaza a la versión anterior v2. Esta transición trae cambios y mejoras significativos que los vendedores y desarrolladores deben tener en cuenta para garantizar un proceso de integración sin problemas. En este artículo, exploraremos los cambios clave en API de Etsy v3 en términos simples, ayudándolo a comprender y adaptarse a estas actualizaciones.

Cambios clave en la API v3 de Etsy y cómo afectan a los vendedores y desarrolladores:

  1. Seguridad mejorada con OAuth 2.0:

Uno de los cambios importantes en Etsy API v3 es la adopción de OAuth 2.0 para autenticación y autorización. OAuth 2.0 es un estándar industrial más seguro y ampliamente utilizado. Garantiza que solo las aplicaciones autorizadas puedan acceder a los datos del vendedor y realizar acciones en su nombre.�


  1. Solicitudes de terminales más claras:�

Etsy API v3 introduce cambios en la forma en que los desarrolladores realizan solicitudes a la API. Con la nueva versión, cada solicitud debe incluir un encabezado “x-API-key” que contenga la clave API de la aplicación de Etsy. Este cambio mejora la seguridad y ayuda a Etsy a realizar un seguimiento de las solicitudes de API de forma más eficaz. Los vendedores y desarrolladores deben actualizar su código para incluir este encabezado cuando se comuniquen con la API de Etsy.


  1. Parámetros de solicitud estándar:

Se ha modificado el manejo de los parámetros de solicitud estándar. El parámetro de consulta “campos”, que se usaba anteriormente para recuperar recursos parciales en v2, ya no se admite en v3.
Si bien el parámetro de consulta “incluye” todavía está 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.

  1. Paginación:

Los usuarios ahora pueden experimentar la paginación actualizada. Los parámetros de consulta “límite” y “desplazamiento” deben usarse para la paginación en lugar del parámetro “página” que se usa en v2. Los registros predeterminados que se devuelven por llamada a la API son 25 y el número máximo de registros que se pueden devolver es 100. Para facilitar la navegación a través de conjuntos de datos más grandes, Etsy proporciona parámetros de límite y compensación. El parámetro de límite le permite especificar el número de registros para recuperar por página. Mientras que el parámetro de desplazamiento lo ayuda a navegar a una página específica de resultados.

Además, la respuesta incluye un campo de recuento, que indica el número total de registros disponibles para la paginación. Tenga en cuenta que, por razones de rendimiento, el parámetro de compensación tiene un valor máximo de 50000, lo que garantiza un manejo eficiente de grandes conjuntos de datos.

 

  1. Ámbitos de recursos:

En la Etsy API v3 actualizada, los ámbitos de recursos para filtrar listas de recursos han pasado de filtros basados ​​en rutas a filtros basados ​​en parámetros de consulta.

Ejemplo: filtrado de listados por ID de tienda y estado

Supongamos que desea filtrar los listados por ID de tienda y estado específicos. En v2, usaría:

/v2/tiendas/:shop_id/listings/active

Con el cambio a v3, el enfoque de URL y parámetro de consulta sería:

/v3/aplicación/listados?shop_id=:shop_id&state=activo

Aquí, incluye los valores deseados para el ID de la tienda y el estado como parámetros de consulta.

  1. Estructura de respuesta mejorada:

En la versión anterior del API de Etsy (v2), 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íficamente, los puntos finales que devuelven listas de recursos ahora incluyen dos campos importantes: “recuento” y “resultados”.

El campo “recuento” indica el número de resultados en la respuesta, lo que proporciona una descripción general rápida 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ácilmente al conteo y recuperar los resultados específicos de la respuesta.


  1. Retiro de Recursos Obsoletos:

Se reemplazaron o eliminaron más de 40 recursos y puntos finales en v3 en varias categorías, como Pago. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection y más. La lista completa de recursos retirados se puede encontrar en la documentación.>>https://developers.etsy.com/documentation/migration/retired-resources/

 

  1. Límites de tasa de API:

 

En Etsy API v3, no ha habido cambios en los límites de velocidad de la API en comparación con v2. Si estabas usando la misma clave API de la aplicación de Etsy en v2, tus límites de tarifas negociados seguirán siendo los mismos en v3 también.

De forma predeterminada, las aplicaciones de Etsy autenticadas con su clave API pueden realizar hasta 10,000 24 solicitudes públicas en un período 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ímite de frecuencia (XNUMX consultas por segundo) garantiza un uso justo y mantiene la estabilidad del sistema.

¿Sabes Tú?

¿Ya tiene una tienda de comercio electrónico basada en Prestashop, Opencart, WooComemrce o Magento 2? ¿Sabe que con el conector del mercado de Etsy de Knowband, puede enumerar y administrar sus productos en el mercado de Etsy?
El conector Knowband Etsy Marketplace viene con los últimos cambios de la API de Etsy V3 y garantiza una integración perfecta entre su sitio web y el mercado de Etsy.
Por ejemplo, puede administrar todos sus pedidos y listados de Etsy directamente desde el panel de administración de su tienda de comercio electrónico. Además, también puede comunicarse con nosotros en support@knowband.com para obtener más información sobre Etsy Marketplace Connector.�

Conclusión:

La transición a Etsy API v3 trae cambios importantes destinados a mejorar la seguridad, simplificar la integración y mejorar la experiencia general para vendedores y desarrolladores. Al comprender y adaptarse a estos cambios, puede asegurarse de que integración con la versión API actualizada de Etsy y aprovechar sus nuevas capacidades de manera efectiva.