Na import katalógu tovaru do Vášho e-shopu potrebujete mať API kľúč, ktorý Vám bude vygenerovaný, Váš názov domény, kde bude e-shop a kód ISO jazyka.
Podpora výstupných formátov je XML a JSON.
Ukážka volania XML súboru tovaru v PHP a cURL:
$apiKey = '1a2b3c4d5e6f7g8h9i';
$host = $_SERVER['SERVER_NAME'];
$url = 'https://cellfastpartner.cz/api-catalog/products';
$language = 'cs'; // cs, sk, pl, en
$outputFormat = 'xml'; // xml, json
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_AUTOREFERER, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'api-key: '.$apiKey,
'Host: '.$host,
'dIMAIN: '.$host,
'Language: cs',
'Content-Type: application/'.$outputFormat.'; charset=UTF-8',
'Accept: application/'.$outputFormat
]);
$response = curl_exec($ch); // formated XML or JSON
curl_close($ch);
header('Content-type: application/'.$outputFormat);
echo $response;
Vysvetlivky k uzlom súboru XML:
- <have_variants> hodnota 0/1 = obsahuje produkt varianty
- <id_product> ID produktu, pre lepšiu orientáciu
- <code> Kód produktu, inak tiež napríklad referencie alebo SKU (ak má produkt varianty, je prázdne)
- <ean13> EAN13 produktu (ak má produkt varianty, je prázdne)
- <name> Názov produktu vo Vami zvolenom jazyku
- <description> Popis produktu v HTML formáte
- <link_rewrite> SEO URL
- <weight> Váha produktu
- <width> Šírka produktu
- <height> Výška produktu
- <minimal_quantity> Minimálny počet pre objednanie (nie je ako násobok)
- <parameters> Ak má produkt parametre / vlastnosti
- <parameter> Parameter / vlastnosť: <name> Názov parametra, <value> Hodnota parametra
- <categories> kategórie produktu oddelené znakom > (pred a za znakom je medzera, napríklad: "Záhrada > Vidle a hrable > Záhradné náradie")
- <images> Obrázky produktu
- <image cover ="1" id="123"> Obrázok produktu (kde atribút cover označuje, či je to hlavný obrázok 0 / 1, id označuje ID obrázku)
- <variants> Varianty (je potrebné skonztrolovať, či existujú podľa prvku 1.)
- <variant> Variant
- <id> ID varianty (hodí sa na párovanie)
- <name> Názov variantu
- <public_name> Publikovaný názov variantu
- <value> Hodnota variantu
- <pairing_images> Párované obrázky vzťahujúce sa k variantu
- <image_id> ID obrázku variantu (páruje sa podľa ID v uzle <image a atribúte ID)
Ukážkové súbory na stiahnutie: