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:

Kokiskashop.hu felület - a termékekkel kapcsolatos aktuális információk gyűjtésére szolgál - árak, elérhetőség, szállítási lehetőségek, rendelés létrehozása,..

Partnerfelület - a megrendelés állapotával kapcsolatos információk gyűjtésére szolgál (elsősorban a fizetéssel kapcsolatban), a rendelésben történő változások jelentése, kigenerált számlák fogadása,...

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 
)

 

BIGtheme.net Joomla 3.3 Templates