Nieuwe update 8.5: Webhooks en API rechten

30-04-2014

Ontwikkelaars opgelet! We hebben vandaag twee nieuwe functionaliteit live gezet.

Webhooks

BiedMeer breidt de functionaliteit voor ontwikkelaars uit met de introductie van webhooks. Webhooks zijn HTTP callbacks, oftewel een HTTP Post verzoek dat getriggerd kan worden als er een bepaalde gebeurtenis plaatsvindt. Je krijgt hiermee de privilege om 'uitstapjes' te maken naar andere applicaties binnen bepaalde processen die plaatsvinden in jouw webwinkel. Hieronder illustreren we het concept van webhooks aan de hand van een voorbeeld.

Voorbeeld: klanten informeren via SMS
Jan wil zijn klanten beter van dienst zijn door ze te informeren via een SMS-systeem dat berichten verstuurd indien de order van status wijzigt. Jan gebruikt hiervoor de diensten van SMSDienst. Sophie is aan het shoppen in de webwinkel van Jan en plaatst op een gegeven moment haar bestelling. De bestelling is betaald en de order wordt definitief gemaakt en krijgt de status 'Nieuw'. Jan heeft de orderbevestiging per e-mail ontvangen en zet de bestelde artikelen klaar voor verzending, hij wijzigt op het moment dat hij hier aan begint de status van de order naar 'In behandeling'.


Op het moment dat Jan de status van de order heeft gewijzigd wordt een gebeurtenis getriggerd en kan informatie worden overlegd met SMSDienst zodat SMSDienst een geautomatiseerd een SMS-bericht kan versturen naar Sophie met daarin de melding dat haar bestelling in behandeling is genomen.

Dit is slechts één van de voorbeelden van de mogelijkheden die webhooks bieden. In dit geval illustreert het een derde partij, waarmee geen integratie binnen BiedMeer is, maar via webhooks wel in staat is taken te verrichten op basis van gebeurtenissen die plaats hebben gevonden en de data die daarbij beschikbaar is.

Welke webhooks zijn er?
Op dit moment zijn er een aantal webhooks beschikbaar waarbij 'geluisterd' kan worden op bepaalde gebeurtenissen. Je kunt inhaken op het beheren van kortingsbonnen, mailinglijsten, orders en producten. Elke webhook resource heeft zijn eigen gebeurtenissen waar op geluisterd kan worden. Raadpleeg hiervoor de documentatie, die vind je op http://www.jouwdomein.nl/API/Docs/index.php#webhook_docs

Webhooks

API rechten

De API van BiedMeer is weer verder uitgebreid. Wanneer je een API key aanmaakt of wijzigt, heb je nu de mogelijkheid om deze rechten toe te wijzen. Voorheen kreeg de key die je aanmaakte de volledige toegang tot de API. Deze had dan toegang tot alle resources. Vanaf nu is er een 'tabblad' met instellingen bij gekomen, waarmee het mogelijk is om bepaalde rechten aan een een key toe te wijzen.

Je kunt dit in het onderhoudspanel vinden via "Startpunt > Mijn webshop > Instellingen > Algemeen > API Gegevens". Klik vervolgens op het tabblad 'Rechten'. Zie de afbeelding hieronder.
API Rechten
Het tabblad "Rechten" is er vanaf nu bijkomen om een API key rechten toe te kennen. Zo kun je bepalen welke resources ze wel of niet bij kunnen. Per 'resource' kun je precies aangeven welke calls er mogen.

Er is ook de mogelijkheid om de key volledige toegang te geven. Let hier bij wel op dat je ook toegang geeft voor de toekomstige nieuwe resources en/of methods.

Met deze nieuwe mogelijkheid kun je als BiedMeer klant bepalen wat de externe partij met de API kan doen. Natuurlijk kun je de rechten weer eenvoudig wijzigen in het onderhoudspanel van BiedMeer.

Cookies

CCV Shop maakt gebruik van cookies. Hierdoor kunnen wij je de nodige functionaliteiten bieden en tevens jouw gebruikservaring verbeteren. Als je onze website bezoekt, ga je akkoord met onze cookieverklaring.

Kies je cookies
Accepteer alle cookies
Voor meer informatie kun je kijken in onze cookieverklaring