O que é a API do Etsy?
Etsy oferece uma API pública para obter e atualizar dados da plataforma. Qualquer API permite que desenvolvedores criem apps com dados únicos e opções de um programa ou site. Da mesma forma, desenvolvedores usam a Etsy API para criar integrações para vendedores e compradores.
Como obter a chave de API do Etsy
Obter acesso à Etsy Web API não requer muito tempo nem esforço. Primeiro, você precisa obter acesso ao site da comunidade de desenvolvedores Etsy, onde pode começar a criar suas próprias aplicações e integrações usando sua chave de API exclusiva. Siga o tutorial da API Etsy abaixo para saber como acessar essa interface de programação.
- Passo 1 – Criar uma conta
Etsy Developers Community e crie uma nova conta ou faça login com a que você já possui.
Você pode se registrar usando seu e-mail ou continuar com sua conta do Google, Facebook ou Apple. - Etapa 2 – Ajustar as Configurações de Segurança
Antes de criar sua primeira aplicação, o serviço exige a configuração de autenticação de dois fatores.
Siga o link e você será redirecionado para a página de parâmetros de segurança.
Você pode escolher entre várias opções: instalar o aplicativo Google Authenticator no seu dispositivo móvel para confirmar seu acesso com o seu código de confirmação. Ao selecionar essa opção, você poderá baixar o aplicativo e conectá-lo ao Portal de Desenvolvedores Etsy via leitura de código QR.
Você também pode escolher verificação por chamada telefônica ou SMS. Ao selecionar essa opção, insira seu número de telefone no campo correspondente. Após clicar em Avançar, você receberá um código por SMS ou uma ligação automática, dependendo da opção escolhida.
- Etapa 3 – Crie uma aplicação
Após ajustar os requisitos de segurança, você já pode começar a criar sua primeira aplicação. Primeiro, preencha o formulário para descrever sua aplicação em potencial.
Conclua o Captcha e pressione Ler Termos e Criar App.
Você poderá ler os Termos e Condições da API Etsy no pop-up. Familiarize-se com o documento para entender os requisitos e restrições ao usar a interface de programação. Marque a caixa e clique em Criar App.
- Passo 4 – Obtenha Suas Credenciais de API
Depois de concordar com os termos e condições, você terá acesso à sua chave de API e ao segredo.
Lembre-se de manter suas credenciais de API em segredo e não as exiba nem as compartilhe com terceiros.
Como usar a API do Etsy
Quando você criar um aplicativo pela primeira vez, ele terá Acesso Provisório padrão aos serviços do Etsy durante o processo de desenvolvimento. O Acesso Provisório oferece as seguintes funções:
- Leitura de recursos abertos e não autenticados, por exemplo, Lojas e Tesouros.
- Acesso autenticado (leitura e escrita) aos dados pertencentes ao proprietário do aplicativo. Esse acesso permite ler dados pessoais como Recibos e Faturamento, e também criar, editar ou excluir Listagens de uma loja. Se necessário, você pode solicitar acesso para um pequeno grupo de usuários de teste além do proprietário do aplicativo.
O Etsy também oferece Acesso Completo, que permite um acesso autenticado a dados ilimitados de membros do Etsy. Se a integração que você estiver desenvolvendo não precisar desses privilégios, você pode usar o app em modo provisório.
requisitos para Acesso Completo.
Exemplos da API Etsy
API de Avaliações do Etsy
A plataforma Etsy apresenta um sistema de Feedback que permite que compradores e vendedores deixem feedback um para o outro sobre transações específicas na Etsy. Ela oferece vários métodos para encontrar tipos específicos de feedback disponíveis na plataforma. São, por exemplo, findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller, e muitos outros.
Aqui está um exemplo do método findAllFeedbackFromBuyers, que permite obter e usar seu feedback de clientes.
| Nome do Método | Feedback de compradores |
| Sinopse | Retorna um conjunto de objetos FeedBack associados a um usuário. Isto é, a união entre os métodos findAllUserFeedbackAsBuyer e findAllUserFeedbackAsSubject. |
| Método HTTP | OBTER |
| URI | /users/:user_id/feedback/from-buyers |
Reviews Widget!”>Se você procura maneiras de exibir avaliações de clientes da sua loja Etsy, experimente o Widget de Avaliações pronto!
API de pagamento Etsy
Pagamentos e a API de Transações representam uma parte das Ferramentas para Vendedores do Etsy. Todas as vendas e compras efetuadas através da plataforma Etsy são divididas em 3 fontes principais: Pedidos, Recibos e Transações. E a API de Pagamento representa um Pagamento realizado com o Etsy Payments.
API de listagem Etsy
API de Listagem Etsy can get seller items with the findAllShopListingsActive method, that finds all active Listings belonging to a shop.
Documentação da API Etsy
Seção de Documentação para seus membros. Há um Guia Básico para desenvolvedores que são novos na API do Etsy para ajudá-los a começar a trabalhar com ela.
FAQ
O Etsy tem uma API?
Sim, o Etsy oferece uma ampla variedade de soluções para desenvolvedores, divididas em duas categorias principais – ferramentas para Vendedores e Compradores. O acesso à API web do Etsy é concedido gratuitamente a um público amplo.
Como encontro o ID da minha listagem no Etsy?
Cada listagem do Etsy possui um identificador exclusivo. Ele pode ser encontrado na URL da listagem. Ao navegar pela listagem do Etsy, o ID fica disponível no final do endereço. As URLs das listagens seguem o formato: www.etsy.com/listing/Listing ID/.
Qual é a minha chave de API do Etsy?
Para usar a API do Etsy, é necessária uma chave de aplicação exclusiva fornecida durante o registro do seu aplicativo. Essa chave de API identifica o aplicativo na plataforma web do Etsy e é usada para monitorar os limites de chamadas.
Onde encontrar minha API do Etsy?
Você pode encontrar sua API exclusiva para cada app Etsy que você criou na sua conta de Desenvolvedor Etsy. Vá para a aba Apps criados e clique no aplicativo correspondente para ver suas credenciais. Se você não tiver uma conta de desenvolvedor ou nenhum aplicativo criado, consulte a segunda seção do nosso artigo acima.
