Comment obtenir et utiliser la clé API Etsy
Qu’est-ce que l’API Etsy ?
Etsy fournit une API publique pour obtenir et mettre à jour des données à partir de la plateforme. Toute API permet aux développeurs de créer des applications basées sur des données et des options uniques d’un programme ou d’un site Web. De la même manière, les développeurs utilisent l’API Etsy pour créer des intégrations pour les vendeurs et les acheteurs.
Comment obtenir une clé API Etsy
Obtenir l’accès à l’API web d’Etsy ne nécessite pas beaucoup de temps ou d’efforts. Tout d’abord, vous devez accéder au site Web de la communauté des développeurs Etsy, où vous pouvez commencer à créer vos propres applications et intégrations en utilisant votre clé API unique. Suivez ce tutoriel sur l’API Etsy ci-dessous pour savoir comment accéder à cette interface de programmation.
- Étape 1 – Créer un compte
Allez sur le site Web de la communauté des développeurs Etsy et créez un nouveau compte ou connectez-vous avec votre compte existant.
Vous êtes libre de vous inscrire en utilisant votre adresse e-mail ou de continuer avec votre compte Google, Facebook ou Apple. - Étape 2 – Ajuster les paramètres de sécurité
Avant de créer votre première application, le service nécessite la configuration d’une authentification à deux facteurs.
Suivez le lien et vous serez redirigé vers la page des paramètres de sécurité.
Vous pouvez choisir parmi plusieurs options : installer une application Google Authenticator sur votre appareil mobile pour confirmer votre accès avec votre propre code de confirmation défini via l’application. Après avoir cliqué sur cette option, on vous propose de télécharger l’application et de la connecter avec le portail des développeurs Etsy via le scanning d’un code QR.
Vous pouvez également choisir la vérification via un appel téléphonique ou un SMS. Lorsque vous choisissez cette option, vous devez saisir votre numéro de téléphone dans le champ correspondant. Après avoir cliqué sur Suivant, vous recevrez un code SMS ou un appel téléphonique automatique, selon l’option que vous avez choisie.
- Étape 3 – Créer une application
Après avoir ajusté les exigences de sécurité, vous pouvez commencer à créer votre première application. Tout d’abord, vous devez remplir le formulaire pour décrire votre application prospective.
Complétez le Captcha et appuyez sur Lire les conditions et créer l’application.
Vous serez invité à lire les conditions d’utilisation de l’API Etsy dans la fenêtre contextuelle. Familiarisez-vous avec le document pour connaître les exigences et les restrictions lors de l’utilisation de l’interface de programmation. Cochez la case et appuyez sur Créer l’application.
- Étape 4 – Obtenez vos informations d’identification API
Après avoir accepté les termes et conditions, vous aurez accès à votre clé API et à votre secret.
N’oubliez pas de garder vos informations d’identification API secrètes et de ne pas les afficher ou les envoyer à des tiers.
Comment utiliser l’API Etsy
Lorsque vous créez une application pour la première fois, elle dispose d’un accès provisoire par défaut aux services Etsy pendant le processus de développement. L’accès provisoire comprend les fonctions suivantes :
- Accès en lecture à toutes les ressources ouvertes et non authentifiées, comme les Boutiques et les Trésors, par exemple.
- Accès authentifié (lecture et écriture) aux données appartenant au propriétaire de l’application. Cet accès permet de lire des données personnelles telles que les Reçus et la Facturation, ainsi que de créer, modifier ou supprimer des Annonces d’une boutique. Si nécessaire, vous pouvez demander l’accès pour un petit groupe d’utilisateurs de test en plus du propriétaire de l’application.
Etsy propose également un accès complet qui offre la possibilité d’accéder de manière authentifiée aux données illimitées des membres Etsy. Si l’intégration que vous développez n’a pas besoin de privilèges comme ceux-ci, vous pouvez simplement utiliser l’application en mode provisoire.
Si vous souhaitez toujours avoir un accès complet pour votre application, vous devez d’abord utiliser l’accès provisoire pour développer l’application et la faire fonctionner correctement, puis vérifier si vous remplissez les conditions d’accès complet de la plateforme.
Exemples d’API Etsy
API des avis Etsy
La plateforme Etsy propose un système de commentaires permettant aux acheteurs et aux vendeurs de laisser des avis l’un pour l’autre sur des transactions spécifiques sur Etsy. Elle propose plusieurs méthodes pour trouver des types spécifiques de commentaires, disponibles sur la plateforme. Il s’agit, par exemple, de findAllUserFeedbackAsAuthor, findAllUserFeedbackAsBuyer, findAllUserFeedbackAsSeller, et bien d’autres.
Voici un exemple de méthode findAllFeedbackFromBuyers, qui vous permet de récupérer et d’utiliser vos commentaires clients.
| Nom de la méthode | findAllFeedbackFromBuyers |
| Synopsis | Retourne un ensemble d’objets FeedBack associés à un utilisateur. Il s’agit essentiellement de l’union entre les méthodes findAllUserFeedbackAsBuyer et findAllUserFeedbackAsSubject. |
| Méthode HTTP | GET |
| URI | /users/:user_id/feedback/from-buyers |
Si vous recherchez des moyens d’afficher les avis clients de votre boutique Etsy, essayez un Widget d’Avis prêt à l’emploi !
API de paiement Etsy
Les API de Paiement et de Transactions représentent une partie des Outils de Vendeur Etsy. Toutes les ventes et tous les achats effectués via la plateforme Etsy sont divisés en 3 sources principales : Commandes, Reçus et Transactions. Et l’API de Paiement représente un paiement effectué avec Etsy Payments.
API de liste Etsy
Les Annonces Etsy sont des articles disponibles à la vente. Chaque Annonce est liée à un Utilisateur et à une Boutique (Utilisateur qui possède cette Boutique). Les Annonces comprennent un prix et une quantité qui leur sont attachés, et lorsqu’elles sont épuisées, le propriétaire de la boutique doit renouveler les articles avant qu’ils puissent être vendus à nouveau. Elle propose des méthodes pour trouver et récupérer des annonces de différentes catégories, ainsi que pour créer et supprimer des annonces. Ces catégories comprennent : Actif, Intéressant, Tendance, Reçu et autres Annonces. L’API de Liste Etsy peut obtenir les articles du vendeur avec la méthode findAllShopListingsActive, qui trouve toutes les Annonces actives appartenant à une boutique.
Documentation de l’API Etsy
Le site Web de la communauté des développeurs Etsy propose une section de Documentation développée pour ses membres. Il y a un guide de base pour les développeurs qui sont nouveaux dans l’interface de programmation Etsy pour les aider à commencer à travailler avec elle. La section unique du portail API des développeurs Etsy est la section Discussion. Tout le monde peut participer à la discussion pour demander de l’aide et partager son expérience et ses cas d’utilisation.
FAQ
Etsy a-t-il une API ?
Oui, Etsy propose une large gamme de solutions pour les développeurs, divisées en 2 principales catégories – Outils pour les Vendeurs et pour les Acheteurs. L’accès à l’API web d’Etsy est accordé gratuitement à un large public.
Comment trouver l'identifiant de ma liste Etsy ?
Chacune des annonces Etsy a un numéro d’identification unique. Il peut être trouvé dans l’URL de l’annonce. Lorsque vous parcourez une annonce Etsy, son ID est disponible à la fin de l’adresse web. Les URL des annonces sont sous ce format : www.etsy.com/listing/ID de l’annonce/.
Quelle est ma clé API Etsy ?
L’utilisation de l’API Etsy nécessite une clé d’application unique fournie lors de l’inscription de votre application. Cette clé API identifie une application sur la plateforme web d’Etsy et est utilisée pour suivre ses limites d’appel.
Où trouver mon API Etsy ?
Vous pouvez trouver votre API unique pour chaque application Etsy que vous avez créée dans votre compte Développeur Etsy. Allez dans l’onglet Applications que vous avez créées et cliquez sur l’application requise pour voir ses informations d’identification. Si vous n’avez pas de compte de développeur ou d’application créée, consultez la deuxième section de notre article ci-dessus.