Principais mudan\u00e7as na API do Etsy v3 e como elas afetam os vendedores e desenvolvedores:<\/span><\/h1>\n\n- \n
Seguran\u00e7a aprimorada com OAuth 2.0:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Uma das mudan\u00e7as importantes no Etsy API v3 \u00e9 a ado\u00e7\u00e3o do OAuth 2.0 para autentica\u00e7\u00e3o e autoriza\u00e7\u00e3o. OAuth 2.0 \u00e9 um padr\u00e3o da ind\u00fastria mais seguro e amplamente utilizado. Ele garante que apenas aplicativos autorizados possam acessar os dados do vendedor e realizar a\u00e7\u00f5es em seu nome.\ufffd<\/span><\/p>\n <\/span><\/p>\n\n- <\/b>
\nSolicita\u00e7\u00f5es de endpoint mais claras:\ufffd<\/b><\/h2>\n<\/li>\n<\/ol>\n
A API Etsy v3 introduz altera\u00e7\u00f5es na forma como os desenvolvedores fazem solicita\u00e7\u00f5es \u00e0 API. Com a nova vers\u00e3o, cada solicita\u00e7\u00e3o deve incluir um cabe\u00e7alho “x-API-key” contendo a chave de API do aplicativo Etsy. Essa altera\u00e7\u00e3o aumenta a seguran\u00e7a e ajuda o Etsy a rastrear solicita\u00e7\u00f5es de API com mais efici\u00eancia. Vendedores e desenvolvedores precisam atualizar seu c\u00f3digo para incluir esse cabe\u00e7alho ao se comunicar com a API do Etsy.<\/span><\/p>\n <\/span><\/p>\n\n- <\/b>
\nPar\u00e2metros de solicita\u00e7\u00e3o padr\u00e3o:<\/b><\/h2>\n<\/li>\n<\/ol>\n
O tratamento de par\u00e2metros de solicita\u00e7\u00e3o padr\u00e3o foi modificado. O par\u00e2metro de consulta “campos”, usado anteriormente para recuperar recursos parciais na v2, n\u00e3o \u00e9 mais compat\u00edvel com a v3.<\/span>
\n<\/span>Embora o par\u00e2metro de consulta “includes” ainda esteja dispon\u00edvel em alguns endpoints, seu suporte \u00e9 limitado. Notavelmente, alguns endpoints agora retornam dados de recursos associados por padr\u00e3o, simplificando a chamada de API.<\/span><\/p>\n <\/span><\/p>\n\n- \n
Pagina\u00e7\u00e3o:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Os usu\u00e1rios agora podem experimentar a pagina\u00e7\u00e3o atualizada. Os par\u00e2metros de consulta “limit” e “offset” devem ser usados \u200b\u200bpara pagina\u00e7\u00e3o em vez do par\u00e2metro “page” usado na v2. Os registros padr\u00e3o retornados por chamada de API s\u00e3o 25 e o n\u00famero m\u00e1ximo de registros que podem ser retornados \u00e9 100. Para facilitar a navega\u00e7\u00e3o por conjuntos de dados maiores, o Etsy fornece par\u00e2metros de limite e deslocamento. O par\u00e2metro limit permite especificar o n\u00famero de registros a serem recuperados por p\u00e1gina. Enquanto o par\u00e2metro offset ajuda voc\u00ea a navegar para uma p\u00e1gina espec\u00edfica de resultados.<\/span><\/p>\nAl\u00e9m disso, a resposta inclui um campo de contagem, indicando o n\u00famero total de registros dispon\u00edveis para pagina\u00e7\u00e3o. Observe que, por motivos de desempenho, o par\u00e2metro offset tem um valor m\u00e1ximo de 50000, garantindo o manuseio eficiente de grandes conjuntos de dados.<\/span><\/p>\n ![\"Escopos](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/Resource-scopes.png\")
<\/a><\/span><\/p>\n <\/p>\n
\n- \n
Escopos de recursos:<\/b><\/h2>\n<\/li>\n<\/ol>\n
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\u00e2metros de consulta.<\/span><\/p>\nExemplo: Filtragem de listagens por ID da loja e estado<\/span><\/p>\nSuponha que voc\u00ea queira filtrar as listagens por um ID de loja e estado espec\u00edficos. Na v2, voc\u00ea usaria:<\/span><\/p>\n\/v2\/shops\/:shop_id\/listings\/active<\/span><\/p>\nCom a mudan\u00e7a para v3, a URL e a abordagem do par\u00e2metro de consulta seriam:<\/span><\/p>\n\/v3\/application\/listings?shop_id=:shop_id&state=active<\/span><\/p>\nAqui, voc\u00ea inclui os valores desejados para o ID da loja e o estado como par\u00e2metros de consulta.<\/span><\/p>\n <\/span><\/p>\n\n- \n
Estrutura de resposta aprimorada:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Na vers\u00e3o anterior do <\/span>API Etsy (v2)<\/span><\/a>, as respostas da API seguiram uma estrutura padronizada. Encapsulando v\u00e1rios 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”.<\/span><\/p>\nO campo “count” denota o n\u00famero de resultados na resposta, fornecendo uma vis\u00e3o geral r\u00e1pida da contagem total de recursos retornados. Por outro lado, o campo “resultados” cont\u00e9m os pr\u00f3prios objetos de recursos reais. Essa estrutura revisada permite que os desenvolvedores acessem facilmente a contagem e recuperem os resultados espec\u00edficos da resposta.<\/span><\/p>\n <\/span><\/p>\n\n- <\/b>
\nRetirada de Recursos Desatualizados:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Mais de 40 recursos e terminais foram substitu\u00eddos ou removidos na v3 em v\u00e1rias categorias, como Pagamento. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection e muito mais. A lista completa de recursos desativados pode ser encontrada na documenta\u00e7\u00e3o.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n
\n- \n
Limites de taxa de API:<\/b><\/h2>\n<\/li>\n<\/ol>\n
![\"O](\"https:\/\/www.knowband.com\/blog\/wp-content\/uploads\/2023\/06\/API-Rate-Limits.png\")
<\/a><\/p>\n <\/p>\n
Na API Etsy v3, n\u00e3o houve altera\u00e7\u00f5es nos limites de taxa da API em compara\u00e7\u00e3o com a v2. Se voc\u00ea estava usando a mesma chave de API do aplicativo Etsy na v2, seus limites de taxa negociados tamb\u00e9m permanecer\u00e3o os mesmos na v3.<\/span><\/p>\nPor padr\u00e3o, os aplicativos Etsy autenticados com sua chave de API podem fazer at\u00e9 10,000 solicita\u00e7\u00f5es p\u00fablicas em um per\u00edodo de 24 horas, oferecendo aos desenvolvedores amplas oportunidades de interagir com a plataforma Etsy e recuperar os dados necess\u00e1rios para seus aplicativos. O limite de taxa (10 consultas por segundo) garante o uso justo e mant\u00e9m a estabilidade do sistema.<\/span><\/p>\n <\/span><\/p>\nVoc\u00ea sabe?<\/b><\/h2>\n
Voc\u00ea j\u00e1 tem uma loja de com\u00e9rcio eletr\u00f4nico baseada em Prestashop, Opencart, WooComemrce ou Magento 2? Voc\u00ea sabia que com o conector de mercado Knowband Etsy, voc\u00ea pode listar e gerenciar seus produtos no mercado Etsy?<\/span>
\n<\/span> O conector Knowband Etsy Marketplace vem com as \u00faltimas altera\u00e7\u00f5es da API Etsy V3 e garante uma integra\u00e7\u00e3o perfeita entre seu site e o mercado Etsy.<\/span>
\n<\/span> Por exemplo, voc\u00ea pode gerenciar todos os seus pedidos e listagens do Etsy diretamente no painel de administra\u00e7\u00e3o da sua loja de com\u00e9rcio eletr\u00f4nico. Al\u00e9m disso, voc\u00ea tamb\u00e9m pode entrar em contato conosco em <\/span>support@knowband.com<\/span><\/a> para obter mais informa\u00e7\u00f5es sobre o Etsy Marketplace Connector.\ufffd<\/span><\/p>\n
Seguran\u00e7a aprimorada com OAuth 2.0:<\/b><\/h2>\n<\/li>\n<\/ol>\n
Uma das mudan\u00e7as importantes no Etsy API v3 \u00e9 a ado\u00e7\u00e3o do OAuth 2.0 para autentica\u00e7\u00e3o e autoriza\u00e7\u00e3o. OAuth 2.0 \u00e9 um padr\u00e3o da ind\u00fastria mais seguro e amplamente utilizado. Ele garante que apenas aplicativos autorizados possam acessar os dados do vendedor e realizar a\u00e7\u00f5es em seu nome.\ufffd<\/span><\/p>\n <\/span><\/p>\n A API Etsy v3 introduz altera\u00e7\u00f5es na forma como os desenvolvedores fazem solicita\u00e7\u00f5es \u00e0 API. Com a nova vers\u00e3o, cada solicita\u00e7\u00e3o deve incluir um cabe\u00e7alho “x-API-key” contendo a chave de API do aplicativo Etsy. Essa altera\u00e7\u00e3o aumenta a seguran\u00e7a e ajuda o Etsy a rastrear solicita\u00e7\u00f5es de API com mais efici\u00eancia. Vendedores e desenvolvedores precisam atualizar seu c\u00f3digo para incluir esse cabe\u00e7alho ao se comunicar com a API do Etsy.<\/span><\/p>\n <\/span><\/p>\n O tratamento de par\u00e2metros de solicita\u00e7\u00e3o padr\u00e3o foi modificado. O par\u00e2metro de consulta “campos”, usado anteriormente para recuperar recursos parciais na v2, n\u00e3o \u00e9 mais compat\u00edvel com a v3.<\/span> <\/span><\/p>\n Os usu\u00e1rios agora podem experimentar a pagina\u00e7\u00e3o atualizada. Os par\u00e2metros de consulta “limit” e “offset” devem ser usados \u200b\u200bpara pagina\u00e7\u00e3o em vez do par\u00e2metro “page” usado na v2. Os registros padr\u00e3o retornados por chamada de API s\u00e3o 25 e o n\u00famero m\u00e1ximo de registros que podem ser retornados \u00e9 100. Para facilitar a navega\u00e7\u00e3o por conjuntos de dados maiores, o Etsy fornece par\u00e2metros de limite e deslocamento. O par\u00e2metro limit permite especificar o n\u00famero de registros a serem recuperados por p\u00e1gina. Enquanto o par\u00e2metro offset ajuda voc\u00ea a navegar para uma p\u00e1gina espec\u00edfica de resultados.<\/span><\/p>\n Al\u00e9m disso, a resposta inclui um campo de contagem, indicando o n\u00famero total de registros dispon\u00edveis para pagina\u00e7\u00e3o. Observe que, por motivos de desempenho, o par\u00e2metro offset tem um valor m\u00e1ximo de 50000, garantindo o manuseio eficiente de grandes conjuntos de dados.<\/span><\/p>\n <\/p>\n 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\u00e2metros de consulta.<\/span><\/p>\n Exemplo: Filtragem de listagens por ID da loja e estado<\/span><\/p>\n Suponha que voc\u00ea queira filtrar as listagens por um ID de loja e estado espec\u00edficos. Na v2, voc\u00ea usaria:<\/span><\/p>\n \/v2\/shops\/:shop_id\/listings\/active<\/span><\/p>\n Com a mudan\u00e7a para v3, a URL e a abordagem do par\u00e2metro de consulta seriam:<\/span><\/p>\n \/v3\/application\/listings?shop_id=:shop_id&state=active<\/span><\/p>\n Aqui, voc\u00ea inclui os valores desejados para o ID da loja e o estado como par\u00e2metros de consulta.<\/span><\/p>\n <\/span><\/p>\n Na vers\u00e3o anterior do <\/span>API Etsy (v2)<\/span><\/a>, as respostas da API seguiram uma estrutura padronizada. Encapsulando v\u00e1rios 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”.<\/span><\/p>\n O campo “count” denota o n\u00famero de resultados na resposta, fornecendo uma vis\u00e3o geral r\u00e1pida da contagem total de recursos retornados. Por outro lado, o campo “resultados” cont\u00e9m os pr\u00f3prios objetos de recursos reais. Essa estrutura revisada permite que os desenvolvedores acessem facilmente a contagem e recuperem os resultados espec\u00edficos da resposta.<\/span><\/p>\n <\/span><\/p>\n Mais de 40 recursos e terminais foram substitu\u00eddos ou removidos na v3 em v\u00e1rias categorias, como Pagamento. ShopListingVariationImage, ShippingProfileUpgrade, User, ShopSection e muito mais. A lista completa de recursos desativados pode ser encontrada na documenta\u00e7\u00e3o.>>https:\/\/developers.etsy.com\/documentation\/migration\/retired-resources\/<\/span><\/p>\n <\/p>\n <\/p>\n Na API Etsy v3, n\u00e3o houve altera\u00e7\u00f5es nos limites de taxa da API em compara\u00e7\u00e3o com a v2. Se voc\u00ea estava usando a mesma chave de API do aplicativo Etsy na v2, seus limites de taxa negociados tamb\u00e9m permanecer\u00e3o os mesmos na v3.<\/span><\/p>\n Por padr\u00e3o, os aplicativos Etsy autenticados com sua chave de API podem fazer at\u00e9 10,000 solicita\u00e7\u00f5es p\u00fablicas em um per\u00edodo de 24 horas, oferecendo aos desenvolvedores amplas oportunidades de interagir com a plataforma Etsy e recuperar os dados necess\u00e1rios para seus aplicativos. O limite de taxa (10 consultas por segundo) garante o uso justo e mant\u00e9m a estabilidade do sistema.<\/span><\/p>\n <\/span><\/p>\n Voc\u00ea j\u00e1 tem uma loja de com\u00e9rcio eletr\u00f4nico baseada em Prestashop, Opencart, WooComemrce ou Magento 2? Voc\u00ea sabia que com o conector de mercado Knowband Etsy, voc\u00ea pode listar e gerenciar seus produtos no mercado Etsy?<\/span>\n
\nSolicita\u00e7\u00f5es de endpoint mais claras:\ufffd<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nPar\u00e2metros de solicita\u00e7\u00e3o padr\u00e3o:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n<\/span>Embora o par\u00e2metro de consulta “includes” ainda esteja dispon\u00edvel em alguns endpoints, seu suporte \u00e9 limitado. Notavelmente, alguns endpoints agora retornam dados de recursos associados por padr\u00e3o, simplificando a chamada de API.<\/span><\/p>\n\n
Pagina\u00e7\u00e3o:<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/span><\/p>\n\n
Escopos de recursos:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
Estrutura de resposta aprimorada:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
\nRetirada de Recursos Desatualizados:<\/b><\/h2>\n<\/li>\n<\/ol>\n
\n
Limites de taxa de API:<\/b><\/h2>\n<\/li>\n<\/ol>\n
<\/a><\/p>\nVoc\u00ea sabe?<\/b><\/h2>\n
\n<\/span> O conector Knowband Etsy Marketplace vem com as \u00faltimas altera\u00e7\u00f5es da API Etsy V3 e garante uma integra\u00e7\u00e3o perfeita entre seu site e o mercado Etsy.<\/span>
\n<\/span> Por exemplo, voc\u00ea pode gerenciar todos os seus pedidos e listagens do Etsy diretamente no painel de administra\u00e7\u00e3o da sua loja de com\u00e9rcio eletr\u00f4nico. Al\u00e9m disso, voc\u00ea tamb\u00e9m pode entrar em contato conosco em <\/span>support@knowband.com<\/span><\/a> para obter mais informa\u00e7\u00f5es sobre o Etsy Marketplace Connector.\ufffd<\/span><\/p>\n