Příklad vložení/editace moto
Některé hodnoty je možné zapisovat více způsoby - např. <manufacturer id="8" /> je ekvivalentní k <manufacturer>Honda</manufacturer> (pro XML).
Dtto "manufacturer@id":8" je pro JSON shodné jako "manufacturer":"Honda".
Můžete si zvolit, co Vám více vyhovuje, ale abyste nemuseli aktualizovat číselníky apod., doporučujeme zápis v hodnotách (ne ID) a v příkladech uvádíme pouze tyto.
XML
Na adresu:https://api.tipmoto.com/c/{ID firmy}/moto.xml
Odešlete následující požadavek (ideálně PUT, kde BODY obsahuje následující XML):
<?xml version="1.0"?>
<tipmoto>
<moto>
<!-- Vaše ID. Doporučujeme používat identifikaci pomocí <idApi>, nikoliv <id>
Nemusíte tak řešit párování mezi našimi-vašimi ID
-->
<idApi>AB-198</idApi>
<!-- ID pobočky firmy.
Není nutné zasílat, pokud má firma pouze jednu pobočku (tak tomu je ve většině případů)
Pokud zasíláte, je zde podporované pouze zasílání přes attribut 'id'
-->
<pobocka id="0" />
<!-- Je inzerát aktivní
'0' = nezobrazuje se
'1' = ano, zobrazuje se
'2' = nezobrazuje se na TipMoto.com, je aktivní v datovém výpisu firmy (pouze pokud si firma možnost zapnula)
'firstInactive' = tuto hodnotu možné uvést pouze při importu = první import nastaví na neaktivní, dále bez změny hodnoty -->
<aktivni>1</aktivni>
<!-- Výrobce motorky (dle číselníku)
Povinné pole při vkládání (nikoliv editaci) -->
<manufacturer>BMW</manufacturer>
<!-- Název inzerátu (model motorky/čtyřkolky bez výrobce)
Povinné pole při vkládání (nikoliv editaci) -->
<nazev>S 1000 R, Hockenheim Silver Metallic</nazev>
<!-- Model motorky (dle číselníku) -->
<model>S 1000 R</model>
<!-- Zařazení motorky (dle číselníku)
Doporučené uvádět -->
<zarazenimoto>silniční sportovní</zarazenimoto>
<!-- Stav vozidla
Možné hodnoty:
'ojetá'
'nová'
'předváděcí'
'bouraná'
'veterán' -->
<stav>nová</stav>
<!-- Objem motorky/čtyřkolky
Povinné pole při vkládání (nikoliv editaci) -->
<objem>ojetá</objem>
<!-- Výkon v kW (decimal 4,1) -->
<vykon>118.0</vykon>
<!-- Rok výroby -->
<vyrobeno>2021</vyrobeno>
<!-- Rok uvedení do provozu -->
<doProvozu>2021</doProvozu>
<!-- Cena (celé číslo)
Uvádí se konečná celá cena s DPH!
0 = cena dohodou, není dovoleno uvádět pro nové moto -->
<cena>389000</cena>
<!-- Měna ceny
'Kč'
'€' -->
<cenaMena>Kč</cenaMena>
<!-- Cena stará (celé číslo)
Původní cena (před slevou) - zobrazena přeškrtnutě
0 (nebo '') = cena není zobrazena -->
<cenaOld>0</cenaOld>
<!-- Odpočet DPH možný
'0' = ne
'1' = ano
'2' = neuvedeno -->
<dph>1</dph>
<!-- Možné splátky/leasing
'0' = ne
'1' = ano
'2' = neuvedeno -->
<splatky>1</splatky>
<!-- Najeto (celé číslo) -->
<najeto>5243</najeto>
<!-- Jednotka pro položku najeto
'km'
'mil'
'mth' -->
<najetoMira>km</najetoMira>
<!-- Dostupnost motorky/čtyřkolky
z agendy /lists/dostupnostmoto.xml -->
<dostupnostmoto>0</dostupnostmoto>
<!-- Původ motorky/čtyřkolky
z agendy /lists/puvodmoto.xml -->
<puvodmoto>ČR</puvodmoto>
<!-- Vozidlo má TP
'0' = ne
'1' = ano (je-li STK = 1, musí být TP = 1)
'2' = neuvedeno -->
<tp>1</tp>
<!-- Vozidlo má platnou STK
'0' = ne
'1' = ano
'2' = neuvedeno -->
<stk>1</stk>
<!-- STK je platné do MM/RRRR -->
<stkDo>04/2027</stkDo>
<!-- Vozidlo má servisní knížku
Nemá vliv na TipMoto, slouží pro další inzertní servery
'0' = ne
'1' = ano
'2' = neuvedeno -->
<serviska>1</serviska>
<!-- VIN vozidla -->
<vin>WB10E5106N6F19653</vin>
<!-- Takty
'' = neuvedeno
'2T'
'4T' -->
<takt>4T</takt>
<!-- ABS
Nemá vliv na TipMoto, slouží pro další inzertní servery
'0' = ne
'1' = ano
'2' = neuvedeno -->
<abs>1</abs>
<!-- Počet válců
Nemá vliv na TipMoto, slouží pro další inzertní servery
'' (prázdné - pro většinu inzerátů)
'Elektromotor'
'1'
'2'
'3'
'4'
'5'
'6' -->
<valce>4</valce>
<!-- Počet majitelů
Nemá vliv na TipMoto, slouží pro další inzertní servery
'' (prázdná - hodnota pro většinu inzerátů) nebo celé nezáporné číslo (kdy 0 = taktéž neuvedeno) -->
<majitelu>1</majitelu>
<!-- Štítky
Možné štítky (uvnitř v tagu label):
'Premium selection' (pouze pro značku BMW)
'Harley-Davidson Originals'
'Importér' -->
<labels>
<label>Premium selection</label>
</labels>
<!-- Interní poznámka pro firmu (chodí v emailu, např. stání apod.) -->
<poznamkaInterni>Stání 83</poznamkaInterni>
<!-- Zařadit do akčních výpisů na TipMoto
'0' = ne
'1' = ano (výchozí hodnota, doporučuje se) -->
<akce>1</akce>
<!-- URL - adresa na webu firmy. Na TipMoto se následně ukáže odkaz -->
<url>https://www.webprodejce.cz/nabizena-motorka.html</url>
<!-- Youtube adresa s videem -->
<youtube>https://youtu.be/xv123456</youtube>
<!-- Popis inzerátu. Může obsahovat HTML formátování -->
<popis><![CDATA[
<p><strong>Zánovní motocykl model 2021 SKLADEM</strong></p>
<p>Prodej od autorizovaného dealera, zkontrolováno v autorizovaném servise!</p>
<p>Zdarma dovozeme po ČR</p>
]]></popis>
<!-- Fotky k inzerátu
Je-li hodnota atributu ignoreimport == true, pak import ignoruje uvedení struktury.
Je-li je hodnota atributu forceupdate == true, pak se vynutí aktualizace všech fotek
(vynucenou aktualizaci neposílejte defaultně, ale jen je-li třeba např. aktualizovat fotky!) -->
<photos ignoreimport="false" forceupdate="false">
<!-- Jednotlivé fotky -->
<photo>
<!-- URL s fotkou ve formátu JPG -->
<url>https://www.webprodejce.cz/ph/AB-198_1.jpg</url>
<!-- Hlavní fotka v přehledu
'0' = ne
'1' = ano -->
<main>1</main>
<!-- Označení fotky (reakce na změnu fotky)
Libovolná textová hodnota. Změní-li se hodnota, dojde k updatu foto (i při shodné URL).
Doporučujeme uvádět např. datetime, filesize, file_hash -->
<stamp>2021-11-30 14:13:43</stamp>
</photo>
<!-- Další fotky -->
<photo>
<url>https://www.webprodejce.cz/ph/AB-198_2.jpg</url>
<main>O</main>
<stamp>2021-11-30 14:13:43</stamp>
</photo>
<photo>
<url>https://www.webprodejce.cz/ph/AB-198_3.jpg</url>
<main>O</main>
<stamp>2021-11-30 14:13:43</stamp>
</photo>
</photos>
<!--Video nahrané k inzerátu
Systém kromě Youtube videa umožňuje nahrát video přímo na TipMoto.com - stáhne se z uvedené URL a zpracuje -->
<videos>
<video>
<!-- URL s videosouborem
Odkaz uvádějte přímo na video, nikoliv webovou stránku -->
<originalUrl>https://www.webprodejce.cz/v/AB-198.mp4</originalUrl>
<!-- Označení videa (reakce na změnu)
Libovolná textová hodnota. Změní-li se hodnota, dojde k updatu videa (i při shodné URL).
Doporučujeme uvádět např. datetime, filesize, file_hash -->
<stamp>2021-11-30 14:14:28</stamp>
</video>
</videos>
</moto>
</tipmoto>Nemáte-li v datech nějaké hodnoty, ideálně vynechte celý element s touho hodnotou.
JSON
Na adresu:https://api.tipmoto.com/c/{ID firmy}/moto.json
Odešlete následující požadavek (ideálně PUT, kde BODY obsahuje následující JSON):Komentáře k jednotlivým hodnotám viz. XML výše
{
"tipmoto": {
"moto": {
"idApi": "AB-198",
"pobocka@id": "0",
"aktivni": "1",
"manufacturer": "BMW",
"nazev": "S 1000 R, Hockenheim Silver Metallic",
"model": "S 1000 R",
"zarazenimoto": "silniční sportovní",
"stav": "ojetá",
"objem": "1000",
"vykon": "118.0",
"vyrobeno": "2021",
"doProvozu": "2021",
"cena": "389000",
"cenaMena": "Kč",
"cenaOld": "",
"dph": "1",
"splatky": "1",
"najeto": "5243",
"najetoMira": "km",
"dostupnostmoto": "0",
"puvodmoto": "ČR",
"tp": "1",
"stk": "1",
"stkDo": "04/2027",
"serviska": "1",
"vin": "WB10E5106N6F19653",
"takt": "4T",
"abs": "1",
"valce": "4",
"majitelu": "1",
"labels": {
"label": [
"Premium selection"
]
},
"poznamkaInterni": "Stání 83",
"akce": "1",
"url": "https://www.webprodejce.cz/nabizena-motorka.html",
"youtube": "https://youtu.be/xv123456",
"popis": "<p><strong>Zánovní motocykl model 2021 SKLADEM</strong></p>\n<p>Prodej od autorizovaného dealera, zkontrolováno v autorizovaném servise!</p>\n<p>Zdarma dovozeme po ČR</p>",
"photos@ignoreimport": "false",
"photos@forceupdate": "false",
"photos": {
"photo": [
{
"url": "https://www.webprodejce.cz/ph/AB-198_1.jpg",
"main": "1",
"stamp": "2021-11-30 14:13:43"
},
{
"url": "https://www.webprodejce.cz/ph/AB-198_2.jpg",
"main": "0",
"stamp": "2021-11-30 14:13:43"
},
{
"url": "https://www.webprodejce.cz/ph/AB-198_3.jpg",
"main": "0",
"stamp": "2021-11-30 14:13:43"
}
]
},
"videos": {
"video": {
"originalUrl": "https://www.webprodejce.cz/v/AB-198.mp4",
"stamp": "2021-11-30 14:14:28"
}
}
}
}
}Nemáte-li v datech nějaké hodnoty, ideálně vynechte řádek (blok) s touho hodnotou.
