Goed nieuws voor developers: wwidgets heeft een nieuwe ontwikkelaarspagina waarop je alles vindt om met onze REST API aan de slag te gaan. Je vindt er uitleg over de API met voorbeelden in cURL, JavaScript, PHP en Python, een vraag-en-antwoordhulp voor snelle antwoorden en een uitleg van de verkoopwebhook die echte bestellingen omzet in meldingen, zonder API-sleutel. In dit artikel lees je wat er op de pagina staat, wat je ermee kunt bouwen en hoe je begint.
Waarom een aparte ontwikkelaarspagina?
Veel gebruikers beheren hun widgets gewoon in het dashboard, en dat blijft de makkelijkste manier. Maar steeds meer webshops, bureaus en freelancers willen wwidgets koppelen aan hun eigen systemen: een webshopplatform, een planningstool, een intern dashboard of een script dat 's nachts draait. Daarvoor heb je duidelijke documentatie nodig, met voorbeelden die je kunt kopiëren en aanpassen. Die informatie hebben we nu op één plek gezet.
Wat vind je op de ontwikkelaarspagina?
Uitleg van de REST API
Met de REST API beheer je je campagnes en widgets en haal je statistieken op. Op de pagina lees je hoe je je verzoeken authenticeert, welke endpoints er zijn en hoe de antwoorden eruitzien. Alles is opgebouwd vanuit praktijkvoorbeelden, zodat je snel ziet hoe je een veelvoorkomende taak uitvoert.
Voorbeelden in vier talen
Elke handeling wordt getoond in cURL, JavaScript, PHP en Python. Zo kun je in de taal van je eigen project beginnen:
- cURL om snel iets te testen vanaf de commandoregel;
- JavaScript voor Node.js-scripts of serverless functies;
- PHP voor WordPress-, WooCommerce- of Magento-projecten;
- Python voor automatiseringen, data-analyse en geplande taken.
Een vraag-en-antwoordhulp
Niet iedereen wil eerst een hele documentatie doorlezen. Met de vraag-en-antwoordhulp op de pagina vind je snel antwoord op veelgestelde vragen, bijvoorbeeld hoe je een widget aan- of uitzet of hoe je statistieken voor een bepaalde periode ophaalt.
De verkoopwebhook
Een van de handigste onderdelen is de verkoopwebhook. Daarmee stuur je echte bestellingen door naar een widget voor recente verkopen, zodat bezoekers meldingen zien van aankopen die echt zijn gedaan. Je hebt daar geen API-sleutel voor nodig: je stuurt de bestelgegevens naar de webhook-URL van je widget. In WooCommerce kun je dat bijvoorbeeld koppelen aan de hook die afgaat als een betaling is voltooid. Zo blijven je meldingen eerlijk en up-to-date, zonder dat je handmatig iets hoeft in te voeren.
Wat kun je bouwen met de wwidgets API?
Een paar voorbeelden van wat developers met de API kunnen doen:
Campagnes synchroniseren
Beheer je meerdere sites of klanten? Dan kun je campagnes vanuit je eigen systeem aanmaken en bijwerken, in plaats van alles handmatig in het dashboard te doen. Handig voor bureaus die voor elke nieuwe klant dezelfde basisinstellingen willen gebruiken.
Widgets aan- en uitzetten volgens een schema
Stel dat je elke vrijdag om 17:00 een weekendactie start en die zondag om 23:59 beëindigt. Met een klein script en een geplande taak zet je de countdown timer en de kortingsbalk automatisch aan en weer uit. Zo hoef je er in het weekend niet aan te denken.
Wekelijkse statistieken in je eigen dashboard
Via de API haal je impressies, hovers, klikken, formulierinzendingen, CTR en conversieratio op. Laat een script dat elke maandagochtend doen en zet de cijfers in een spreadsheet, je BI-tool of een intern dashboard. Zo zie je de prestaties van je widgets naast je andere cijfers.
Bestellingen uit WooCommerce of Shopify doorsturen
Met de verkoopwebhook stuur je nieuwe bestellingen uit je webshop direct door naar je widget voor recente verkopen. Op WooCommerce koppel je dat aan de hook voor een voltooide betaling; op Shopify kun je met een webhook of automatisering de bestelgegevens doorsturen. Het resultaat: meldingen die gebaseerd zijn op echte aankopen.
Overzicht: wat heb je nodig?
| Onderdeel | Wat je nodig hebt |
|---|---|
| REST API (campagnes, widgets, statistieken) | API-sleutel, abonnement E-Commerce World of proefperiode |
| Verkoopwebhook voor recente verkopen | Webhook-URL van je widget, geen API-sleutel |
| Codevoorbeelden | cURL, JavaScript, PHP of Python |
| Limiet | 60 verzoeken per minuut |
Hoe begin je met de API?
- Controleer je abonnement. De API zit in het abonnement E-Commerce World (14 euro per maand) en is ook beschikbaar tijdens de gratis proefperiode van 14 dagen. De abonnementen vergelijk je op de prijspagina.
- Maak je API-sleutel aan. Die vind je in je account onder Account → API. Bewaar de sleutel veilig en zet hem nooit in code die in de browser draait.
- Open de ontwikkelaarspagina. Kies op de ontwikkelaarspagina een voorbeeld in je favoriete taal en probeer het eerst met cURL.
- Bouw je eerste koppeling. Begin klein, bijvoorbeeld met het ophalen van statistieken, en breid daarna uit.
- Houd rekening met de limiet. De API staat 60 verzoeken per minuut toe. Voor de meeste koppelingen is dat ruim voldoende; plan grotere synchronisaties in batches.
Tips voor een stabiele koppeling
- Bewaar je sleutel op de server, bijvoorbeeld in een omgevingsvariabele, en niet in je front-end of in een openbare repository.
- Vang fouten netjes op. Krijg je een foutmelding omdat je de limiet bereikt, wacht dan even en probeer het opnieuw.
- Haal alleen op wat je nodig hebt. Statistieken per week of per dag zijn vaak genoeg; je hoeft niet elke minuut te vragen.
- Test eerst op één campagne voordat je wijzigingen op al je sites of klanten doorvoert.
- Gebruik voor bestellingen de webhook, niet de API. Dat is eenvoudiger en je hebt er geen sleutel voor nodig.
Een voorbeeld uit de praktijk
Neem een webwinkel in Antwerpen die elke maand een themaweek organiseert. Zonder API moet iemand op maandagochtend de countdown timer en de kortingsbalk aanzetten en ze aan het einde van de week weer uitzetten. Met een klein Python-script en een geplande taak gebeurt dat automatisch. Hetzelfde script haalt op maandag de statistieken van de afgelopen week op en zet ze in een gedeelde spreadsheet, zodat het team in één oogopslag ziet hoeveel vertoningen, klikken en aanmeldingen de actie heeft opgeleverd. Ondertussen stuurt WooCommerce elke voltooide betaling via de verkoopwebhook door naar de widget voor recente verkopen. Niemand hoeft daar nog iets voor te doen, en alles wat bezoekers zien, is gebaseerd op echte gegevens.
Voor wie is dit interessant?
De ontwikkelaarspagina is bedoeld voor iedereen die wwidgets wil koppelen aan andere systemen: developers bij webshops, bureaus die meerdere klanten beheren, freelancers die WordPress- of WooCommerce-sites bouwen en marketeers met een beetje technische kennis die hun rapportages willen automatiseren. Bouw je sites voor klanten? Kijk dan ook eens naar ons partnerprogramma.
Veelgestelde vragen over de wwidgets API
Heb ik een API-sleutel nodig voor de verkoopwebhook?
Nee. Voor de verkoopwebhook stuur je bestelgegevens naar de webhook-URL van je widget voor recente verkopen. Een API-sleutel heb je alleen nodig voor de REST API, waarmee je campagnes, widgets en statistieken beheert.
In welk abonnement zit de API?
De API zit in het abonnement E-Commerce World. Je kunt hem ook gebruiken tijdens de gratis proefperiode van 14 dagen, zodat je je koppeling kunt bouwen en testen voordat je kiest.
Hoeveel verzoeken mag ik doen?
De limiet is 60 verzoeken per minuut. Voor de meeste toepassingen, zoals wekelijkse statistieken of het schakelen van widgets volgens een schema, is dat ruim voldoende.
Ga aan de slag
Met de nieuwe ontwikkelaarspagina is het makkelijker dan ooit om wwidgets in je eigen workflow op te nemen: campagnes synchroniseren, widgets automatisch schakelen, statistieken in je dashboard zetten of echte bestellingen doorsturen. Nog geen account? Start je gratis proefperiode van 14 dagen, maak je sleutel aan onder Account → API en probeer je eerste verzoek.
