open api

Bem-vindo!

Etsy é um mercado global de produtos exclusivos e criativos. Somos movidos pela nossa missão de: manter o comércio humano. A API aberta da Etsy oferece suporte a centenas de integrações usadas por milhares de vendedores. Este espaço é uma nova forma de colaborarmos diretamente com desenvolvedores como você.

O que estamos fazendo

Estamos desenvolvendo uma nova versão da nossa API aberta. No último ano, construímos uma nova base para endpoints atualizados e elaboração de nova documentação. O objetivo deste trabalho é atender às necessidades da comunidade de desenvolvedores da Etsy e tornar mais fácil para nossa equipe atualizar rapidamente a API aberta quando essas necessidades mudarem.

Open API v3 se concentra em três casos de uso principais: gerenciamento de listagem, gerenciamento de pedidos pós-compra e gerenciamento de loja. Construímos aproximadamente 70 endpoints que atendem a esses casos de uso e eles estão prontos para receber seu feedback. Você pode explorar esses novos endpoints, incluindo especificações de solicitação e resposta, em nosso novo site de referência de API.

Por que estamos construindo abertamente

Passamos muito tempo examinando dados e gráficos, mas reconhecemos que nossos usuários conhecem melhor suas necessidades. Também temos um palpite de que muitos de vocês compartilham as mesmas necessidades. Ao compartilhar nossos planos, documentação e progresso no Github, podemos todos trabalhar juntos para construir a API aberta que você precisa.

Como começar

Criamos um novo site de documentação para Open API v3, que pode ser encontrado em developers.etsy.com/documentation. Continuaremos adicionando novos conteúdos, mas fornecemos um guia de migração e documentamos alguns princípios básicos da API. Se você estiver procurando documentação específica ou tiver feedback, sinta-se à vontade para criar um problema.

Qualquer desenvolvedor com um aplicativo Etsy ativo pode fazer solicitações usando nossos endpoints Open API v3. Visite etsy.com/developers/your-apps para encontrar sua chave de API.

Links úteis para começar

• Migrando para v3
• Autenticação OAuth2
• Fazendo solicitações
• Documentos de referência da API v3
• Especificação OpenAPI JSON

Que tipo de feedback procuramos?

Adoraríamos ouvir sobre solicitações de recursos, alterações propostas no esquema de endpoint, relatórios de bugs e quaisquer problemas de documentação. Abra um problema para sugerir uma alteração ou deixe um feedback geral.

Como fornecer feedback

Criamos vários modelos de problemas para facilitar para você. Geralmente, bugs e solicitações de recursos para API v3 ou documentos devem ser problemas do Github. Todo o resto deve ser enviado como solicitação de suporte para [email protected].

Também pretendemos facilitar o fornecimento de feedback diretamente de nossos documentos de referência da API. Cada definição de endpoint inclui um link para registrar um bug ou solicitação de recurso com alguns detalhes preenchidos.

Observe que, ao enviar seu feedback, temos o direito de usá-lo.

Em termos jurídicos, isso significa que é considerado não confidencial e não proprietário para você, e você concede à Etsy uma licença não exclusiva, mundial, isenta de royalties, irrevogável, sublicenciável e perpétua para usar e publicar essas ideias e materiais para qualquer finalidade, sem compensação para você.

Diretrizes da comunidade

Também incluímos o Código de Conduta de Código Aberto da Etsy. Esperamos que todos os membros da comunidade cumpram este código ao participarem de discussões ou fornecerem feedback.

© 2011-2021 Etsy, Inc. Todos os direitos reservados. A utilização deste código está sujeita aos Termos de utilização do programador API da Etsy, disponíveis em https://www.etsy.com/legal/api