Principais mudanças na API do Etsy v3 e como elas afetam os vendedores e desenvolvedores:
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.�
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.
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.
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.
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.
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.
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/
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.