Bonne nouvelle pour les développeurs et les équipes techniques : wwidgets a désormais une page développeurs dédiée à son API REST. Tu y trouves des exemples prêts à copier en cURL, JavaScript, PHP et Python, un assistant questions-réponses et la documentation du webhook de ventes, qui transforme tes vraies commandes en notifications sans clé API. Voici ce que contient cette page, ce que tu peux construire avec et comment démarrer en quelques minutes.
Pourquoi une page développeurs ?
Jusqu'ici, beaucoup d'utilisateurs géraient leurs widgets uniquement depuis le tableau de bord. C'est parfait pour une boutique, mais les agences, les développeurs freelance et les e-commerçants qui automatisent leur activité nous demandaient plus : synchroniser des campagnes avec leurs propres outils, activer des widgets selon un planning, récupérer les statistiques dans leurs tableaux de bord.
L'API existait déjà ; il manquait un point d'entrée clair, avec des exemples concrets. C'est le rôle de la nouvelle page développeurs wwidgets : expliquer l'API simplement, pour que tu passes moins de temps à chercher et plus de temps à construire.
Que contient la page développeurs ?
- Une présentation de l'API REST : les ressources disponibles (campagnes, widgets, statistiques), l'authentification par clé et le format des réponses.
- Des exemples de code en quatre langages : cURL pour tester rapidement en ligne de commande, JavaScript, PHP et Python pour l'intégrer dans tes projets.
- Un assistant questions-réponses : pose ta question (« comment désactiver un widget ? », « comment récupérer les clics de la semaine ? ») et obtiens une réponse orientée vers les bons appels.
- La documentation du webhook de ventes : comment envoyer tes commandes réelles au widget « Ventes récentes ».
Le webhook de ventes : des notifications réelles, sans clé API
C'est sans doute la partie la plus utile pour les e-commerçants. Le widget « Ventes récentes » affiche des notifications du type « Sophie, de Toulouse, vient de commander... ». Pour que ces notifications soient crédibles, elles doivent refléter de vraies commandes.
Le widget « Ventes récentes » te fournit une adresse de webhook. Il suffit que ta boutique y envoie les informations de commande quand un paiement est validé, par exemple avec le hook de paiement terminé de WooCommerce, ou avec une automatisation équivalente sur Shopify. Aucune clé API n'est nécessaire pour ce webhook.
Résultat : ta preuve sociale reste honnête, à jour et automatique. Plus besoin de saisir quoi que ce soit à la main.
Qu'est-ce que tu peux construire avec l'API ?
Quelques idées concrètes, que l'on retrouve dans les exemples de la page :
Synchroniser tes campagnes
Tu gères plusieurs sites ou plusieurs clients ? Crée et mets à jour tes campagnes depuis ton propre outil interne, au lieu de répéter les mêmes réglages à la main dans chaque compte.
Activer et désactiver des widgets selon un planning
Tu prépares une vente flash du vendredi 18 h au dimanche minuit ? Un petit script lancé par une tâche planifiée (cron) active le compte à rebours et la barre de coupon au bon moment, puis les désactive à la fin. Fini les oublis un dimanche soir.
Récupérer les statistiques dans tes tableaux de bord
Impressions, survols, clics, envois de formulaire, taux de clic et taux de conversion : récupère chaque semaine les chiffres de tes widgets et affiche-les dans ton tableur, ton outil de reporting ou le tableau de bord que tu fournis à tes clients.
Envoyer tes commandes WooCommerce ou Shopify
Grâce au webhook de ventes, chaque commande payée devient une notification. Pense à n'envoyer que le strict nécessaire (par exemple le prénom et la ville) pour respecter la vie privée de tes clients.
À quoi ressemble un appel ?
Sans entrer dans tous les détails, le principe est classique : tu envoies une requête HTTPS à l'API avec ta clé dans l'en-tête, et tu reçois une réponse en JSON. Sur la page développeurs, chaque exemple existe en cURL, JavaScript, PHP et Python, avec la même logique : lister tes campagnes, modifier l'état d'un widget, lire les statistiques d'une période. Tu peux copier l'exemple, remplacer la clé et l'identifiant, et tester immédiatement.
Un exemple de scénario complet
Imaginons une boutique WooCommerce de thés et d'accessoires, basée à Lille. Chaque commande payée est envoyée au webhook du widget « Ventes récentes » : les visiteurs voient des achats réels, sans aucune saisie manuelle. Le jeudi soir, une tâche planifiée appelle l'API pour activer le compte à rebours de la vente du week-end, puis le désactive le lundi matin. Enfin, chaque lundi, un script Python récupère les impressions, clics et taux de conversion de la semaine et les ajoute à un tableur partagé avec l'équipe. Trois automatisations simples, qui font gagner du temps chaque semaine et évitent les erreurs.
Quelles sont les limites ?
L'API accepte jusqu'à 60 requêtes par minute. C'est largement suffisant pour la synchronisation, les plannings et les rapports. Si tu traites beaucoup de données, regroupe tes appels et mets en cache les réponses qui changent peu, comme la liste des campagnes.
Qui a accès à l'API ?
L'API est incluse dans la formule E-Commerce World (14 €/mois) et pendant l'essai gratuit de 14 jours. Tu peux donc tout tester avant de t'engager. Compare les formules sur la page des tarifs.
Comment obtenir ta clé API ?
- Connecte-toi à ton compte wwidgets (ou crée-en un avec l'essai gratuit).
- Va dans Compte, puis API.
- Génère ta clé et garde-la en lieu sûr : ne la publie jamais dans du code côté navigateur ni dans un dépôt public.
- Ouvre la page développeurs, choisis ton langage et lance ton premier appel.
Conseil de sécurité : appelle l'API depuis un serveur ou une fonction côté serveur, pas directement depuis le JavaScript de ta page publique, pour que ta clé ne soit jamais visible.
Pour qui est-ce utile ?
- Les agences qui gèrent les widgets de plusieurs clients et veulent des rapports automatiques.
- Les développeurs freelance qui intègrent wwidgets dans des sites WooCommerce, Shopify, Magento ou sur mesure.
- Les e-commerçants techniques qui automatisent leurs promotions et leur reporting.
- Les équipes marketing qui veulent centraliser leurs chiffres dans un seul tableau de bord.
Et si tu n'es pas développeur ? Pas de souci : tout ce que fait l'API se fait aussi depuis le tableau de bord. L'API est un plus pour automatiser, pas une obligation.
FAQ sur l'API wwidgets
Faut-il une clé API pour le webhook de ventes ?
Non. Le webhook du widget « Ventes récentes » ne demande aucune clé API. La clé sert uniquement aux appels de l'API REST.
Quels langages sont documentés ?
La page développeurs propose des exemples en cURL, JavaScript, PHP et Python. Comme c'est une API REST classique en JSON, tu peux l'utiliser depuis n'importe quel autre langage.
Puis-je tester l'API sans payer ?
Oui. L'API est incluse pendant l'essai gratuit de 14 jours, puis dans la formule E-Commerce World.
Cette page développeurs est une première étape pour rendre wwidgets plus facile à intégrer dans tes outils et tes projets. Jette un œil aux exemples, teste un premier appel, et dis-nous ce qui te manque. Pour commencer, crée ton compte d'essai gratuit et récupère ta clé dans Compte, puis API.
