Podłączenie API
Za pomocą interfejsu aplikacji można łączyć się z Kokiskashop.pl zdalnie co umożliwia integrację z innymi systemami. Obecne API korzysta z architektury RESTfull która jest do wdrożenia technologicznie przyjazna.
Wzajemna wymiana danych składa się z dwóch części:
W celu ułatwienia komunikacji ze wszystkimi partnerami, system został tak skonstruowany, że może dostarczyć więcej rozwiązań. Aktualnie jest dostepne rozwiązanie wg standardu Heureka.cz (viz dokumentace), które posiada rozszerzenie uwierzytelnienia użytkownika. Do odpowiedzi służy format JSON.
Aktywacja usługi
Aby korzystać z API, niezbędna jest aktywacja z naszej strony, która przeprowadza się dla konkretnej API (obecnie tylko typ Heureka) i konta uzytkownika. W przypadku zainteresowania prosimy o kontakt z nami pod adresem partner@kokiskashop.pl. partner@kokiskashop.pl.
Jak wywołać usługę
Aby uprościć implementację, postanowiliśmy zapewnić drobne wsparcie w języku PHP. Wywołanie zdalnego serwera w PHP jest najczęściej wykonywane przy użyciu biblioteki curl.
W poniższym przykładzie zostanie wykorzystana klasa RequestFactory, którą można pobrać tutaj.
Określanie dostępności trzech produktów:
Wszystkie dane użyte w przykładach są jedynie ilustracyjne.
< ?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 = "http://www.kokiskashop.pl/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
)