Frankie moto s.r.o

Jít na TipMoto >

REST-API


Jako novinku máme read/write REST-API
Toto rozhraní preferujeme před importy na míru, které jsou zpoplatněny dle náročnosti!
Vice na api.tipmoto.com

Import dat na TipMoto.com na míru

Obecně o importu

Pakliže máte naprogramovaný vlastní systém, můžeme načítat Vaše data.
Přesto bychom Vám spíše doporučovali obrácený postup, kdy načítáte naše data - viz. popis exportního rozhraní.
Některé položky jsou postupně doplňovány, některé položky jsou důležité pro filtrování v TipMotu, avšak na webu firmy nejsou potřeba, a proto považujeme tento postup za vhodnější.

Způsob předávání dat a formát

Preferujeme způsob, kdy si z Vašeho serveru stahujeme XML soubor s danými daty.
Pakliže by Vám vyhovoval jiný způsob, kontaktujte nás, abychom se dohodli, zda je tento způsob možný.
Pokud zasíláte i motorky i díly nebo příslušenství, je možné dodávat data jak v jednom datovém souboru, tak i odděleně ve více.

Datové položky

Aktuální seznam datových položek (pro motorky, díly i příslušenství) naleznete ve specifikaci XML exportu nebo ještě lépe v agendě lists v API. Není nutné zasílat data o firmě. Čím více položek uvedete, tím lépe (je dle nich např. filtrováno při pokročilém hledání na serveru apod.). Pokud neuvedete některou položku, je můžeme ji místo neuvedení nastavit dle dohody i nějakou defaultní hodnotu.
Pokud chcete používat co nejvíce shodná zařazení, můžete použít naše číselníky.
Chcete-li zpracovávat samostatně modely motorek/čtyřkolek mimo číselníky, můžete použít samostatnou databázi modelů.

Pokud nemáte některé datové položky shodné s našimi číselníky (např. zařazení motorky), zašlete nám i Váš číselník, abychom jej mohli spárovat s našimi hodnotami.

Povinné položky - obecně

Povinnou položkou je ID inzerátu u Vás na serveru. Bez něj nedokážeme data synchronizovat. Další povinnou položkou je koncová cena včetně DPH. Není-li cena uvedena, popř. je-li cena nulová, je nastavena cena dohodou (dovoleno pro zboží, které není označeno jako "nové").

Povinné položky - moto

Povinné jsou zejména položky identifikující motorku/čtyřkolku - výrobce, model.
Uvádějte objem v ccm
Pokud nabízíte i nové i ojeté motocykly, tak rozlišení ojetá/nová
Vzhledem k hledání v systému Vám doporučujeme uvádět model motocyklu dle naší databáze modelů. Toto však není povinné. Pokud nejsou modely vyplněny, algoritmus se snaží modely doplnit.
Velmi doporučené je uvádění zařazení motorky (terénní, silniční sportovní apod.).

Povinné položky - díly

U dílu je povinné uvádět motocykl, pro který je daný díl určený. Ideální je použití našich číselníků. Pokud je nemáte implementované, snažíme se algoritmicky najít daný model. Pokud model nenalezneme v naší databázi, nebude inzerát zveřejněn.
Dále je povinností uvádět druh dílu. Bereme i jiná řazení, než naše, ale pokud Vaše kategorie nelze vhodně spárovat s naší, nejsou pak takové inzeráty zveřejněny.

Povinné položky - příslušenství

U příslušenství je nutné dodat rozlišení stavu. Dále jej pak přiřadit tak, aby odpovídal naší kategorizaci + uvedení povinných parametrů. Toto je možné určit i např. z Vaší kategorizace. Pokud Vaše kategorie nelze vhodně spárovat s naší, nejsou pak takové inzeráty zveřejněny.

Zpracování dat - fotografie, časová razítka

U fotografií uvádějte vždy absolutní URL adresu na nezmenšenou fotografii ve Vašem systému.
Abychom reagovali na případné změny fotografií, doporučujeme Vám buď v datech u fotografie dodávat časové razítko, kdy došlo naposledy k její změně, nebo při změně fotografie změnit i její URL. Předejdeme tak zbytečné zátěži stahování všech fotografií z Vašeho serveru.
Druhou variantou je uvádění času změny přímo u inzerátu. Uvedete-li časové razítko u konkrétní položky, tak vždy zpracujeme pouze danou položku. Nemusíte pak dodávat časové razítko k jednotlivým fotografiím.

Atom 1.0 RSS 2
© 2003-2024 MotoStar.cz & Jiří Kalenský & itDesign (grafika)
Ochrana osobních údajů
Zpracování cookies
Tyto webové stránky používají k poskytování služeb a analýze návštěvnosti soubory cookie. Používáním těchto webových stránek souhlasíte s použitím souborů cookie. Další informace