De EazyMatch API kan werken op diverse manieren.
- via REST
- via JSON
- via geserialiseerde PHP
Voor developers hebben we een standaard code beschikbaar in PHP om connectie te maken met het systeem. Deze collectie van classes maakt het mogelijk om direct alle beschikbare functionaliteit te benaderen. Een kopie van EazyConnect kan je downloaden via GitHub: https://github.com/eazymatch/EazyConnect of https://github.com/viancen/eazymatch-api (composer package)
Gebruik maken van EazyConnect
EazyConnect is een verzameling van bestanden waarmee connectie gemaakt kan worden met het core systeem van eazymatch, de API. Al het verkeer verloopt via https. De basis url voor de EazyMatch api is https://core.eazymatch.net.
EazyConnect maakt gebruik van autoloading classes. Hiervoor dient deze extensie voor PHP te zijn ge-installeerd. EazyConnect heeft minimaal php versie 5.2.17 nodig om te werken. Daarnaast dient de extensie voor CURL te zijn ge-installeerd.
EazyConnect gebruikt een eigen autoloader functie om de juiste bestanden in te laden. Deze wordt gedefinieerd in bootstrap.autoload.php. Daarnaast worden er een aantal basis classes ge-include in het bestand bootstrap.include.php.
POST
Via REST worden er alleen POST requests verwacht. De data dient als form-data te worden verstuurd.
Getting started, configuratie.
In de zip staat een bestand config.php. Hierin moeten de key, secret en instantie naam waarmee u toegang heeft tot het systeem worden ingevuld. Daarnaast kan er een setting gedaan worden om foutmeldingen vanaf de API wel of niet te onderdrukken (debug).
config.php
return array( // slug name of eazymatch instance 'instance' => 'instantienaam', // public eazymatch key 'key' => 'public-key', // private secret 'secret' => 'private-secret', // debug mode ? 'debug' => 'true', );
De connectiekey en secret zijn op te vragen bij EazyMatch. Stuur hiervoor een e-mail naar support@eazymatch.nl of bel naar 020 221 27 05
De gehele map met alle bestanden moeten worden ge-upload naar uw eigen website. Gebruik hiervoor de map die u zelf wil. Voor het gemak gaan we in de voobeelden uit dat alles in een map “EazyConnect” staat op de relatief aan het “testbestand”.
De calls via EazyConnect zijn als volgt opgebouwd:
TheConnection -> TheController -> TheMethod ( Parameters );