Exploring the Changes in Etsy API v3

Exploring the Changes in Etsy API v3- Knowband

Etsy, o popular mercado online, apresentou sua versão mais recente da API, Etsy API v3, substituindo a versão v2 mais antiga. Essa transição traz mudanças e melhorias significativas que os vendedores e desenvolvedores precisam estar cientes para garantir um processo de integração tranquilo. Neste artigo, vamos explorar as principais mudanças em API Etsy v3 em termos simples, ajudando você a entender e se adaptar a essas atualizações.

Principais mudanças na API do Etsy v3 e como elas afetam os vendedores e desenvolvedores:

  1. Segurança aprimorada com OAuth 2.0:

Uma das mudanças importantes no Etsy API v3 é a adoção do OAuth 2.0 para autenticação e autorização. OAuth 2.0 é um padrão da indústria mais seguro e amplamente utilizado. Ele garante que apenas aplicativos autorizados possam acessar os dados do vendedor e realizar ações em seu nome.�


  1. Solicitações de endpoint mais claras:�

A API Etsy v3 introduz alterações na forma como os desenvolvedores fazem solicitações à API. Com a nova versão, cada solicitação deve incluir um cabeçalho “x-API-key” contendo a chave de API do aplicativo Etsy. Essa alteração aumenta a segurança e ajuda o Etsy a rastrear solicitações de API com mais eficiência. Vendedores e desenvolvedores precisam atualizar seu código para incluir esse cabeçalho ao se comunicar com a API do Etsy.


  1. Parâmetros de solicitação padrão:

O tratamento de parâmetros de solicitação padrão foi modificado. O parâmetro de consulta “campos”, usado anteriormente para recuperar recursos parciais na v2, não é mais compatível com a v3.
Embora o parâmetro de consulta “includes” ainda esteja disponível em alguns endpoints, seu suporte é limitado. Notavelmente, alguns endpoints agora retornam dados de recursos associados por padrão, simplificando a chamada de API.

  1. Paginação:

Os usuários agora podem experimentar a paginação atualizada. Os parâmetros de consulta “limit” e “offset” devem ser usados ​​para paginação em vez do parâmetro “page” usado na v2. Os registros padrão retornados por chamada de API são 25 e o número máximo de registros que podem ser retornados é 100. Para facilitar a navegação por conjuntos de dados maiores, o Etsy fornece parâmetros de limite e deslocamento. O parâmetro limit permite especificar o número de registros a serem recuperados por página. Enquanto o parâmetro offset ajuda você a navegar para uma página específica de resultados.

Além disso, a resposta inclui um campo de contagem, indicando o número total de registros disponíveis para paginação. Observe que, por motivos de desempenho, o parâmetro offset tem um valor máximo de 50000, garantindo o manuseio eficiente de grandes conjuntos de dados.

Escopos de recursos na API Etsy da Knowband

 

  1. Escopos de recursos:

Na API Etsy v3 atualizada, os escopos de recursos para filtrar listas de recursos passaram de filtros baseados em caminho para filtros baseados em parâmetros de consulta.

Exemplo: Filtragem de listagens por ID da loja e estado

Suponha que você queira filtrar as listagens por um ID de loja e estado específicos. Na v2, você usaria:

/v2/shops/:shop_id/listings/active

Com a mudança para v3, a URL e a abordagem do parâmetro de consulta seriam:

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

Aqui, você inclui os valores desejados para o ID da loja e o estado como parâmetros de consulta.

  1. Estrutura de resposta aprimorada:

Na versão anterior do API Etsy (v2), as respostas da API seguiram uma estrutura padronizada. Encapsulando vários campos e objetos aninhados. No entanto, no Etsy API v3, as respostas foram alteradas. Especificamente, os terminais que retornam listas de recursos agora incluem dois campos importantes: “contagem” e “resultados”.

O campo “count” denota o número de resultados na resposta, fornecendo uma visão geral rápida da contagem total de recursos retornados. Por outro lado, o campo “resultados” contém os próprios objetos de recursos reais. Essa estrutura revisada permite que os desenvolvedores acessem facilmente a contagem e recuperem os resultados específicos da resposta.


  1. Retirada de Recursos Desatualizados:

Mais de 40 recursos e terminais foram substituídos ou removidos na v3 em várias categorias, como Pagamento. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection e muito mais. A lista completa de recursos desativados pode ser encontrada na documentação.>>https://developers.etsy.com/documentation/migration/retired-resources/

 

  1. Limites de taxa de API:

O limite de taxa da API é a principal mudança no Etsy API V3- Knowband

 

Na API Etsy v3, não houve alterações nos limites de taxa da API em comparação com a v2. Se você estava usando a mesma chave de API do aplicativo Etsy na v2, seus limites de taxa negociados também permanecerão os mesmos na v3.

Por padrão, os aplicativos Etsy autenticados com sua chave de API podem fazer até 10,000 solicitações públicas em um período de 24 horas, oferecendo aos desenvolvedores amplas oportunidades de interagir com a plataforma Etsy e recuperar os dados necessários para seus aplicativos. O limite de taxa (10 consultas por segundo) garante o uso justo e mantém a estabilidade do sistema.

Você sabe?

Você já tem uma loja de comércio eletrônico baseada em Prestashop, Opencart, WooComemrce ou Magento 2? Você sabia que com o conector de mercado Knowband Etsy, você pode listar e gerenciar seus produtos no mercado Etsy?
O conector Knowband Etsy Marketplace vem com as últimas alterações da API Etsy V3 e garante uma integração perfeita entre seu site e o mercado Etsy.
Por exemplo, você pode gerenciar todos os seus pedidos e listagens do Etsy diretamente no painel de administração da sua loja de comércio eletrônico. Além disso, você também pode entrar em contato conosco em support@knowband.com para obter mais informações sobre o Etsy Marketplace Connector.�

Conclusão:

A transição para a API Etsy v3 traz mudanças importantes destinadas a aumentar a segurança, simplificar a integração e melhorar a experiência geral para vendedores e desenvolvedores. Ao compreender e adaptar-se a essas mudanças, você pode garantir integração com a versão atualizada da API do Etsy e alavancar seus novos recursos de forma eficaz.

Adrienne

We are professionals in the eCommerce industry, specializing in plugin development. With years of experience, We provide the best plugins for platforms like - Magento, Prestashop, OpenCart and Shopify. We also offer custom module development and customization services for websites and modules. Our team remains at the forefront of industry trends, delivering cutting-edge solutions to enhance eCommerce website functionality. With a customer-centric approach, our company is trusted partner for eCommerce plugin solutions.

Leave a Reply

Your email address will not be published. Required fields are marked *