open api

¡Bienvenido!

Etsy es un mercado global de productos únicos y creativos. Nos impulsa nuestra misión de: mantener el comercio humano. La API abierta de Etsy admite cientos de integraciones utilizadas por miles de vendedores. Este espacio es una nueva forma de colaborar directamente con desarrolladores como usted.

que estamos haciendo

Estamos desarrollando una nueva versión de nuestra Open API. Durante el último año, construimos una nueva base para actualizar puntos finales y redactar nueva documentación. El objetivo de este trabajo es satisfacer las necesidades de la comunidad de desarrolladores de Etsy y facilitar que nuestro equipo actualice rápidamente la API abierta cuando esas necesidades cambien.

Open API v3 se centra en tres casos de uso principales: gestión de listados, gestión de pedidos posteriores a la compra y gestión de tiendas. Construimos aproximadamente 70 puntos finales que abordan esos casos de uso y están listos para recibir sus comentarios. Puede explorar estos nuevos puntos finales, incluidas las especificaciones de solicitud y respuesta, en nuestro nuevo sitio de referencia de API.

Por qué estamos construyendo al aire libre

Hemos pasado mucho tiempo analizando datos y gráficos, pero reconocemos que nuestros usuarios conocen mejor sus necesidades. También tenemos el presentimiento de que muchos de ustedes comparten las mismas necesidades. Al compartir nuestros planes, documentación y progreso en Github, todos podemos trabajar juntos para crear la API abierta que necesita.

Cómo empezar

Hemos creado un nuevo sitio de documentación para Open API v3, que se puede encontrar endevelopers.etsy.com/documentation. Continuaremos agregando contenido nuevo, pero proporcionamos una guía de migración y documentamos algunos conceptos básicos de API. Si busca documentación específica o tiene comentarios, no dude en crear un problema.

Cualquier desarrollador con una aplicación de Etsy activa puede realizar solicitudes utilizando nuestros puntos finales Open API v3. Visita etsy.com/developers/your-apps para encontrar tu clave API.

Enlaces útiles para empezar

• Migrando a v3
• Autenticación OAuth2
• Hacer solicitudes
• Documentos de referencia de API v3
• Especificación JSON de OpenAPI

¿Qué tipo de comentarios estamos buscando?

Nos encantaría recibir información sobre solicitudes de funciones, cambios propuestos en el esquema de puntos finales, informes de errores y cualquier problema de documentación. Abra un problema para sugerir un cambio o dejar comentarios generales.

Cómo proporcionar comentarios

Hemos creado varias plantillas de problemas para que sea más fácil para usted. Generalmente, los errores y las solicitudes de funciones para API v3 o documentos deberían ser problemas de Github. Todo lo demás debe enviarse como solicitud de soporte a [email protected].

También intentamos facilitar el envío de comentarios directamente desde nuestros documentos de referencia de API. Cada definición de punto final incluye un enlace para presentar una solicitud de error o función con algunos detalles completos.

Tenga en cuenta que al enviar sus comentarios, tenemos derecho a utilizarlos.

Desde el punto de vista legal, esto significa que se considera no confidencial y no propietario para ti, y le otorgas a Etsy una licencia no exclusiva, mundial, libre de regalías, irrevocable, sublicenciable y perpetua para usar y publicar esas ideas y materiales para cualquier propósito, sin compensación para usted.

Pautas comunitarias

También hemos incluido el Código de conducta de código abierto de Etsy. Esperamos que todos los miembros de la comunidad respeten este código cuando participen en debates o proporcionen comentarios.

© 2011-2021 Etsy, Inc. Todos los derechos reservados. El uso de este código está sujeto a los Términos de uso para desarrolladores de API de Etsy, disponibles en https://www.etsy.com/legal/api