API csatlakozás
Az alkalmazási felület segítségével lehetséges a távolról való hozzáférés a Kokiskashop.hu-hoz és így lehetővé téve az integrációt más rendszerbe. Jelenleg az API az úgynevezett RESTfull szerkezeten alapul, ezért a kivitelezése technikailag nem igényes.
A kölcsönös adatcsere két részből tevődik össze:
Annak érdekében, hogy lehetséges legyen a komunikáció közvetítése, a rendszer úgy lett megtervezve, hogy több alkalmazási felületet biztosítson.
A szolgáltatás aktiválása
Ha használni szeretné az API-t, aktiválnunk kell a szolgáltatást. Mindíg a konkrét felhasználói fiók és API kerül aktiválásra. Amennyiben felkeltettük érdeklődését, értesítsen minket e-mailen partner@kokiskashop.hu.
Hogyan hívja a szolgáltatást
Az implementáció érdekében úgy döntöttünk, hogy apró segítséget nyújtunk PHP nyelven. A távoli szerver invokációja PHP-ben a leggyakrabban az alábbi könyvtár segítségével végezzük curl.
A következő példához az úgynevezett RequestFactory osztály lett felhasználva, melyet letölthet itt.
Három termék elérhetőségének megállapítása:
A példákban felhasznált összes adat kizárólag szemléltető jellegű..
< ?php //include wrapper for curl library include ('./RequestFactory.php'); //initiate array $data['products'] = array(); //add first product $data['products'][] = array('id' => 599, 'count' => 2); //add next products $data['products'][] = array('id' => 1091, 'count' => 1); //add next products $data['products'][] = array('id' => 109, 'count' => 6); //add authentification info $data['login'] = "yourLogin"; //password as plain text $data['password'] = "yourPassword"; //password as hashcode $data['password'] = hash("sha256", "yourPassword"); //set url for request $url = "https://www.kokiskashop.hu/api/heureka/1/products/availability"; //choose method of request - products/availability should be GET $method = RequestFactory::$METHOD_GET; //make request and get response in JSON $jsonResponse = RequestFactory::doRequest($url, $data, $method); //decode response - bacause it is possible to handle big integers, it necessary //to set up json_decode function $response = json_decode($jsonResponse, TRUE, 512, JSON_BIGINT_AS_STRING); //now one has associative array. Print it print_r($response); ?> OUTPUT: Array ( [products] => Array ( [0] => Array ( [id] => 599 [available] => 1 [count] => 2 [delivery] => 0 [name] => Stan pro 6 osob [price] => 3327 [priceTotal] => 6654 ) [1] => Array ( [id] => 1091 [available] => 1 [count] => 1 [delivery] => 0 [name] => Didgeridoo 130 cm [price] => 461 [priceTotal] => 461 ) [2] => Array ( [id] => 109 [available] => 0) ) [priceSum] => 7115 )