Pro import katalogu zboží do Vašeho e-shopu potřebujete mít API klíč, který Vám bude vygenerován, Váš název domény, kde bude e-shop a kód ISO jazyka.
Podpora výstupních formátů je XML a JSON.
Ukázka volání XML souboru zboží 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;
Vysvětlivky k uzlům souboru XML:
- <have_variants> hodnota 0 / 1 = obsahuje produkt varianty
- <id_product> ID produktu, pro lepší orientaci
- <code> Kód produktu, jinak také například reference nebo SKU (pokud má produkt varianty, je prázdné)
- <ean13> EAN13 produktu (pokud má produkt varianty, je prázdné)
- <name> Název produktu ve Vámi zvoleném jazyce
- <description> Popis produktu v HTML formátu
- <link_rewrite> SEO URL
- <weight> Váha produktu
- <width> Šířka produktu
- <height> Výška produktu
- <minimal_quantity> Minimální počet pro objednání (není jako násobek)
- <parameters> Pokud má produkt parametry / vlastnosti
- <parameter> Parametr / vlastnost: <name> Název parametru, <value> Hodnota parametru
- <categories> kategorie produktu oddělené znakem > (před a za znakem je mezera, například: "Zahrada > Vidle a hrábě > Zahradní nářadí")
- <images> Obrázky produktu
- <image cover ="1" id="123"> Obrázek produktu (kde atribut cover označuje, jestli je to hlavní obrázek 0 / 1, id označuje ID obrázku)
- <variants> Varianty (je potřeba zkonztrolovat, jestli existují podle prvku 1.)
- <variant> Varianta
- <id> ID varianty (hodí se k párování)
- <name> Název varianty
- <public_name> Publikovaný název varianty
- <value> Hodnota varianty
- <pairing_images> Párované obrázky vztahující se k variantě
- <image_id> ID obrázku varianty (páruje se podle ID v uzlu <image a atributu ID)
Ukázkové soubory ke stažení: