Language:

Cómo obtener y usar la clave de la API de Etsy

Si desea obtener y recuperar sus listados de Etsy, mostrar las reseñas de su tienda en el sitio web o gestionar los datos de transacciones de manera más fácil, considere trabajar con la API de Etsy. En este artículo, encontrará algunos consejos útiles sobre cómo obtener y usar la clave de API, así como algunos ejemplos de la API de Etsy.
Share:
Compartir en Facebook
Share on X
Share on LinkedIn
Share on WhatsApp
Copy Link
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.

    Registro de desarrollador de Etsy
    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.

    Verificar la cuenta de desarrollador de Etsy

    Sigue el enlace y serás redirigido a la página de parámetros de seguridad.

    Autenticación de dos factores de Etsy

    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.

    Aplicación autenticadora de Etsy

    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.

    Autenticación de SMS y teléfono de Etsy
  • 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.

    Crear aplicación API de Etsy

    Completa el Captcha y presiona Leer Términos y Crear App.

    Crear aplicación de Etsy

    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.

    Términos y condiciones de desarrollador de Etsy
  • 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.

    Clave de API de Etsy
    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étodofindAllFeedbackFromBuyers
SinopsisDevuelve un conjunto de objetos FeedBack asociados a un Usuario. Esencialmente, es la unión entre los métodos findAllUserFeedbackAsBuyer y findAllUserFeedbackAsSubject.
Método HTTPGET
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.

Ambos tienen métodos para encontrar y recuperar pagos y transacciones por una tienda, listado, comprador, recibo, etc.

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.