Cómo obtener y usar la clave de la API de Etsy
¿Qué es Etsy API?
Etsy proporciona una API pública para obtener y actualizar datos de la plataforma. Cualquier API permite a los desarrolladores crear aplicaciones basadas en datos y opciones únicas de un programa o sitio web. De manera similar, los desarrolladores utilizan la API de Etsy para crear integraciones para vendedores y compradores.
Cómo obtener la clave de la API de Etsy
Obtener acceso a la API web de Etsy no requiere mucho tiempo ni esfuerzo. Primero, debes obtener acceso al sitio web de la comunidad de desarrolladores de Etsy, donde puedes comenzar a crear tus propias aplicaciones e integraciones utilizando tu clave de API única. Sigue este tutorial de API de Etsy a continuación para saber cómo se puede acceder a esta interfaz de programación.
- Paso 1 – Crea una cuenta
Ve al sitio web de la Comunidad de Desarrolladores de Etsy y regístrate para obtener una nueva cuenta o inicia sesión con la que ya tienes.
Puedes registrarte utilizando tu dirección de correo electrónico o continuar con tu cuenta de Google, Facebook o Apple. - Paso 2 – Ajusta la configuración de seguridad
Antes de crear tu primera aplicación, el servicio requiere configurar una autenticación de dos factores.
Sigue el enlace y serás redirigido a la página de parámetros de seguridad.
Puedes elegir entre varias opciones: instalar una aplicación Google Authenticator en tu dispositivo móvil para confirmar tu acceso con tu propio código de confirmación establecido a través de la aplicación. Después de hacer clic en esta opción, se te ofrecerá descargar la aplicación y conectarla con el portal de desarrolladores de Etsy mediante el escaneo del código QR.
También puedes elegir la verificación mediante llamada telefónica o SMS. Al elegir esta opción, debes ingresar tu número de teléfono en el campo correspondiente. Después de hacer clic en Siguiente, recibirás un código SMS o una llamada telefónica automática, según la opción que elijas.
- Paso 3 – Crea una aplicación
Después de ajustar los requisitos de seguridad, puedes comenzar a crear tu primera aplicación. Primero, debes completar el formulario para describir tu aplicación prospectiva.
Completa el Captcha y presiona Leer Términos y Crear App.
Se te ofrecerá leer los Términos y Condiciones de la API de Etsy en el popup. Familiarízate con el documento para estar al tanto de los requisitos y restricciones al utilizar la interfaz de programación. Marca la casilla y presiona Crear App.
- Paso 4 – Obtén tus credenciales de API
Después de aceptar los términos y condiciones, obtendrás acceso a tu clave de API y secreto.
Recuerda mantener tus credenciales de API en secreto y no mostrarlas ni enviarlas a terceros.
Cómo usar la API de Etsy
Cuando creas una aplicación por primera vez, tiene acceso provisional predeterminado a los servicios de Etsy durante el proceso de desarrollo. El Acceso Provisional cuenta con las siguientes funciones:
- Acceso de lectura a cualquier recurso abierto y no autenticado, como Tiendas y Tesoros, por ejemplo.
- Acceso autenticado (lectura y escritura) a los datos pertenecientes al propietario de la aplicación. Este acceso brinda la oportunidad de leer datos personales como Recibos y Facturación, y también crear, editar o eliminar Listados de una tienda. Si es necesario, puedes solicitar acceso para un pequeño grupo de usuarios de prueba además del propietario de la aplicación.
Etsy también ofrece Acceso Completo que ofrece una opción para acceder autenticado a datos ilimitados de miembros de Etsy. Si la integración que estás desarrollando no necesita privilegios como estos, simplemente puedes usar la aplicación en modo provisional.
Si aún deseas tener acceso completo para tu aplicación, primero debes usar el Acceso Provisional para desarrollar la aplicación y hacer que funcione correctamente y luego verificar si cumples con los requisitos de Acceso Completo de la plataforma.
Ejemplos de la API de Etsy
API de reseñas de Etsy
La plataforma de Etsy cuenta con un sistema de Feedback que permite a compradores y vendedores dejar comentarios entre sí sobre transacciones específicas en Etsy. Ofrece varios métodos para encontrar tipos específicos de comentarios, disponibles en la plataforma. Son, por ejemplo, findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller, y muchos otros.
Aquí tienes un ejemplo de un método findAllFeedbackFromBuyers, que te permite obtener y usar tus comentarios de clientes.
| Nombre del método | findAllFeedbackFromBuyers |
| Sinopsis | Devuelve un conjunto de objetos FeedBack asociados a un Usuario. Esencialmente, es la unión entre los métodos findAllUserFeedbackAsBuyer y findAllUserFeedbackAsSubject. |
| Método HTTP | GET |
| URI | /users/:user_id/feedback/from-buyers |
Si estás buscando formas de mostrar reseñas de clientes de tu tienda de Etsy, ¡prueba un Widget de Reseñas listo para usar!
API de pagos de Etsy
El API de Pagos y Transacciones representa una parte de las Herramientas para Vendedores de Etsy. Todas las ventas y compras realizadas a través de la plataforma de Etsy se dividen en 3 fuentes principales: Pedidos, Recibos y Transacciones. Y el API de Pagos representa un Pago realizado con Pagos de Etsy.
API de listados de Etsy
Los Listados de Etsy son artículos disponibles para la venta. Cada Listado está conectado a un Usuario y una Tienda (Usuario que es propietario de esta Tienda). Los Listados tienen precio y cantidad adjuntos a ellos, y cuando se agotan, el propietario de la tienda debe renovar los artículos antes de que puedan volver a venderse. Cuenta con métodos para encontrar y recuperar listados de diversas categorías, y también para crear y eliminar listados. Estas categorías incluyen: Activo, Interesante, Tendencia, Recibo y otros Listados. El API de Listados de Etsy puede obtener artículos del vendedor con el método findAllShopListingsActive, que encuentra todos los Listados activos pertenecientes a una tienda.
Documentación de la API de Etsy
El sitio web de la comunidad de desarrolladores de Etsy ofrece una sección de Documentación desarrollada para sus miembros. Hay una guía básica para aquellos desarrolladores que son nuevos en la interfaz de programación de Etsy para ayudarlos a comenzar a trabajar con ella. La sección única del portal de API de Desarrolladores de Etsy es la sección de Discusión. Todos pueden participar en la discusión para pedir ayuda y compartir su experiencia y casos.
Preguntas frecuentes
¿Etsy tiene una API?
Sí, Etsy ofrece una amplia gama de soluciones para desarrolladores, divididas en 2 categorías principales: herramientas para vendedores y compradores. El acceso a la API web de Etsy se otorga de forma gratuita a un amplio público.
¿Cómo encuentro mi ID de listado de Etsy?
Cada uno de los listados de Etsy tiene un número de identificación único. Se puede encontrar en la URL del listado. Al navegar por el listado de Etsy, su ID está disponible al final de una dirección web. Las URL de los listados tienen este formato: www.etsy.com/listing/ID del listado/.
¿Cuál es mi clave de API de Etsy?
Usar la API de Etsy requiere una clave de aplicación única proporcionada durante el registro de tu aplicación. Esta clave de API identifica una aplicación en la plataforma web de Etsy y se utiliza para rastrear sus límites de llamada.
¿Dónde encuentro mi API de Etsy?
Puedes encontrar tu API única para cada aplicación de Etsy que hayas creado en tu cuenta de Desarrollador de Etsy. Ve a la pestaña de Aplicaciones que has hecho y haz clic en la aplicación requerida allí para ver sus credenciales. Si no tienes una cuenta de desarrollador o una aplicación creada, consulta la segunda sección de nuestro artículo arriba.