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
)