Getting started

Momenteel bevind onze API zich in versie 1, wanneer er een nieuwe versie uitkomt zal je deze hier eveneens terug kunnen vinden.

Voor het gebruiken van de meest recente Spari API heb je als eerst onze huidige PHP Class library nodig. Deze kan je eenvoudig downloaden via deze link.

Initialize

Wanneer je onze API gaat gebruiken is het nodig om de volgende JavaScript te gebruiken om onze API te kunnen benaderen. Dit kan je doen met behulp van de volgende code:

<!-- Create the DOM element first -->
<div id="spari-box"></div>

<!-- Load our JavaScript file (dont forget to use your public api key!) -->
<script type="text/javascript" src="http://api.spari.nl/v1/js/loader.js?key=PUBLIC_API_KEY_HERE&css=default"></script>

<!-- Finally, load the dynamic Spari contents -->
<script type="text/javascript">
  SpariLoader('firstUse', 'spari-box');
</script>

Deze code zal ervoor zorgen dat alle JavaScript features ingeladen worden en de standaard login opties weergeven. Zodra een gebruiker zich aanmeld bij Spari via deze content, zal de webwinkel webhook een sessie hash id ontvangen. Wanneer je deze opslaat in jouw database, kan je ervoor zorgen voortaan standaard bij Spari is ingelogd via jouw webwinkel.

De volgende JavaScript functie kan aangeroepen worden zodra je beschikt over een sessie hash id:

<!-- Allow our JavaScript to validate the customer features -->
<script type="text/javascript">
  SpariGetCustomerID("customer_spari_hash_id_goes_here");
</script>

Tips & Tricks

Webwinkel

Wanneer je onze API voor een webwinkel gaat gebruiken, is het aangeraden om de initialize JavaScript aan te roepen op de winkelwagen pagina. Zo zorg je ervoor dat de Workflow van je afreken process zo eenvoudig mogelijk gaat.