api.tipmoto.com » Dokumentace API » Agendy » Seznam firem » Firma » Moto

Agenda moto

Obsahuje inzeráty motocyklů

Přehled podagend

Název Strojový název WRITE
Fotografie photo ANO
Video video ANO
Historie cen ceny NE
Statistika stats NE

Funkce agendy

Název Možnosti
Podporované metody GET, PUT/POST, DELETE
Podpora úrovně detailu ✔
Podpora filtrace ✔
Podpora fulltextu ✔
Podpora stránkování ✔
Podpora řazení ✔
Podpora externích identifikátorů ✔
Podpora schémat https://api.tipmoto.com/schemas/moto-{export|import}{-enum}.{xsd|rng}
Podpora ?fail-on-warning ✔
Podpora dry-run ✔
Vrací location ✔

Položky agendy

Str. název Název Typ Informace rw iu P S ➀ ➁
id ID inzerátu v agendě moto integer         ✔ ✔ ✔
idApi externí ID inzerátu string 64   ✔     ✔ ✔ ✔
aktivni aktivní select Možné hodnoty:
  • 0 Ne
  • 1 Ano
  • 2 Web firmy
Atribut firstInactive Pouze při importu dat = nejprve neaktivní, pak bez vlivu		   ✔ ✔ ✔ ✔ ✔
lastModified Poslední úprava datetime Formát YYYY-MM-DD HH:MM:SS ✔ ✔ ✔ ✔ ✔
pobocka Pobočka string 128 Zobrazuje se a zpracovává se pouze má-li firma více poboček           ✔
pobocka@id ID pobočky integer Zobrazuje se a zpracovává se pouze má-li firma více poboček ✔   ✔ ✔   ✔
kontakt Kontakt element Kontakt u inzerátu – telefony, e-mail a web, které se u inzerátu ukazují místo údajů pobočky (adresa, název prodejce a otevírací doba zůstávají z pobočky). Kontakty firmy jsou v agendě kontakt.
Zobrazuje se pouze u firem s aspoň jedním kontaktem, pak u každého inzerátu (i s id="0"). Atribut ref odkazuje na kontakt, u id="0" chybí.		           ✔
kontakt@id ID kontaktu integer 0 = výchozí kontakt pobočky, jinak ID kontaktu téže firmy. Kontakt, který firma nemá (např. smazaný), se vypíše jako 0.
Zápis <kontakt id="N"/>: bez prvku nebo s prázdným id se kontakt nemění, nový inzerát dostane 0. Nečíselné ID vrátí chybu „Neplatné ID kontaktu '…'“, neexistující kontakt nebo kontakt jiné firmy chybu „Firma '…' nemá kontakt id '…'“.		 ✔     ✔   ✔
manufacturer Výrobce string 64 Možné importovat výrobce textově
Výrobce je z agendy manufacturer		 ✔ ✔ ✔ ✔   ✔
manufacturer@id ID výrobce integer Při importu má přednost ID. Povinné je buď text nebo ID. ✔ ✔ ✔ ✔   ✔
nazev Název motorky / čtyřkolky string 64   ✔ ✔ ✔ ✔   ✔
model Model motorky / čtyřkolky string 64 Možné importovat model textově
Model je z agendy model		 ✔ ✔   ✔   ✔
model@id ID modelu integer Při importu má přednost ID. ✔ ✔   ✔   ✔
zarazenimoto Zařazení string 64 Možné importovat zařazení textově
Zařazení je z agendy zarazenimoto		 ✔ ✔ ✔ ✔   ✔
zarazenimoto@id ID zařazení integer Při importu má přednost ID. Povinný je buď text nebo ID. ✔ ✔ ✔ ✔   ✔
stav Stav vozidla select Možné hodnoty:
  • ojetá
  • nová
  • předváděcí
  • bouraná
  • veterán
 ✔ ✔ ✔ ✔    
objem Objem string 16 Objem je z agendy objem ✔ ✔ ✔ ✔    
vykon Výkon v kW decimal 4,1   ✔ ✔   ✔    
vyrobeno Rok výroby string 16 Standardně 4místné číslo (rok), ale historicky string ✔ ✔   ✔    
doProvozu Rok uvedení do provozu string 16 Standardně 4místné číslo (rok), ale historicky string ✔ ✔   ✔    
cena Cena integer Hodnota 0 = cena dohodou (toto není dovoleno pro nové moto) ✔ ✔ ✔ ✔    
cena@historie Historie cen href Odkaz na historii cen (podagenda ceny)            
cenaMena Měna string 8 Prakticky nabývá těchto hodnot:
  • Kč
  • €
 ✔ ✔ ✔ ✔    
cenaOld Původní cena integer Hodnota 0 = není uvedeno ✔ ✔     ✔  
dph Odpočet DPH select Možné hodnoty:
  • 0 Ne
  • 1 Ano
  • 2 Neuvedeno
 ✔ ✔ ✔ ✔    
splatky Splátky / leasing select Možné hodnoty:
  • 0 Ne
  • 1 Ano
  • 2 Neuvedeno
 ✔ ✔ ✔ ✔    
najeto Najeto hodnota string 16 Uvádí číslo pro najeto, avšak historicky je povolen text! ✔ ✔   ✔    
najetoMira Jednotka najeto string 8 Prakticky nabývá těchto hodnot:
  • km
  • mil
  • mth
 ✔ ✔   ✔    
dostupnostmoto Dostupnost integer Dostupnost je z agendy dostupnostmoto ✔ ✔ ✔ ✔    
puvodmoto Původ select Původ je z agendy puvodmoto ✔ ✔ ✔ ✔    
tp Technický průkaz select Možné hodnoty:
  • 0 Ne
  • 1 Ano
  • 2 Neuvedeno
 ✔ ✔ ✔ ✔    
stk STK select Možné hodnoty:
  • 0 Ne
  • 1 Ano
  • 2 Neuvedeno
 ✔ ✔ ✔ ✔    
stkDo Platnost STK do string Formát MM/RRRR ✔ ✔        
serviska Servisní knížka select Na TipMoto se nepoužívá. Pouze pro další inzertní servery
Možné hodnoty:
  • 0 Ne
  • 1 Ano
  • 2 Neuvedeno
 ✔ ✔        
vin VIN string 32   ✔ ✔   ✔    
prevodovka Převodovka select Možné hodnoty:
  • prázdná
  • auto
  • manual
 ✔ ✔   ✔    
takt Počet taktů select Možné hodnoty:
  • prázdná
  • 2T
  • 4T
 ✔ ✔   ✔    
abs ABS select Na TipMoto se nepoužívá. Pouze pro další inzertní servery
Možné hodnoty:
  • prázdná Neuvedeno (pouze pro import)
  • 0 Ne
  • 1 Ano
  • 2 Neuvedeno (pro export i import) – výchozí hodnota
 ✔ ✔        
valce Počet válců select Na TipMoto se nepoužívá. Pouze pro další inzertní servery
Možné hodnoty:
  • prázdná = neuvedeno
  • Elektromotor
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
 ✔ ✔        
majitelu Počet majitelů select Na TipMoto se nepoužívá. Pouze pro další inzertní servery
Možné hodnoty:
  • prázdná, 0 = neuvedeno
  • kladné celé číslo = počet majitelů
 ✔ ✔        
labels/label Štítek select Možné hodnoty:
  • Premium selection pouze pro moto značky BMW
  • Harley-Davidson Originals
  • Importér
 ✔ ✔        
poznamkaInterni Interní poznámka string 64   ✔ ✔   ✔    
nove nové select Uvedeno z kompatibilních důvodů. Nahrazeno stav
Možné hodnoty:
  • 0 Ne
  • 1 Ano
 ✔   ✔ ✔   ✔
predvadeci Ve stavu předváděcí select Uvedeno z kompatibilních důvodů. Nahrazeno stav
Možné hodnoty:
  • 0 Ne
  • 1 Ano
 ✔   ✔ ✔    
bourane Ve stavu bourané select Uvedeno z kompatibilních důvodů. Nahrazeno stav
Možné hodnoty:
  • 0 Ne
  • 1 Ano
 ✔   ✔ ✔    
veteran Jedná se o veterána select Uvedeno z kompatibilních důvodů. Nahrazeno stav
Možné hodnoty:
  • 0 Ne
  • 1 Ano
 ✔   ✔ ✔    
akce V akci select Možné hodnoty:
  • 0 Ne
  • 1 Ano
 ✔ ✔ ✔      
url URL u firmy string 255   ✔ ✔        
youtube Odkaz na YouTube video. Když z odkazu nejde určit ID videa, API vrátí varování a video se u inzerátu nezobrazí. string 1024   ✔ ✔        
vlozeniCas Čas vložení datetime Formát YYYY-MM-DD HH:MM:SS       ✔    
editaceCas Čas poslední editace datetime Formát YYYY-MM-DD HH:MM:SS, může být prázdné       ✔    
urlTipmoto URL na TipMoto.com string 255              
urlTipmotoSubdomain URL na subdoménu string 255              
popis Popis text Může obsahovat HTML ✔ ✔        
photos@ignoreimport Neimportovat fotky logical Používá se pouze u importu. Možné hodnoty:
  • true
  • false
 ✔          
photos@forceupdate Přepsat fotky logical Používá se pouze u importu. Možné hodnoty:
  • true
  • false
Pozor: všechny fotky se stáhnou znovu a dostanou nová ID (i nové URL). Neposílejte trvale, jen když fotky opravdu potřebujete načíst znovu.		 ✔          
photos@reorder Seřadit fotky podle importu logical Používá se pouze u importu. Možné hodnoty:
  • true = galerie se seřadí podle pořadí fotek v photos
  • false = pořadím hýbou jen main a sortOrder (výchozí)
Viz Pořadí a hlavní fotka.		 ✔          
photo@modify Úprava fotografií select Používá se pouze u importu. Možné hodnoty:
  • trim = má-li fotka rámeček, dojde k jeho automatickému oříznutí
 ✔          
photo/id ID fotky integer Odkazuje se na agendu photo            
photo/url URL fotky string 255   ✔          
photo/main Hlavní fotka select Možné hodnoty:
  • 1 nebo true Ano – fotka se stane hlavní a přesune se na pozici 1
  • 0 nebo false Ne – samo o sobě pořadím nehýbe
V exportu vždy 0 nebo 1.
Bez main se při importu hlavní fotka nemění (u inzerátu bez fotek je hlavní první fotka; výjimku při smazání hlavní fotky popisuje Pořadí a hlavní fotka). Má-li main = 1 více fotek, platí první z nich.
Neplatná hodnota se ignoruje a v odpovědi přijde warning, takže s ?fail-on-warning se inzerát nezpracuje.		 ✔          
photo/sortOrder Pořadí fotky integer Pozice fotky v galerii inzerátu, 1 = hlavní fotka.
V exportu je to pozice, na které fotku ukazuje web.
V importu nepovinné: absolutní pozice, na kterou se fotka postaví; ostatní fotky vyplní zbylá místa. Číslo větší než počet fotek znamená konec galerie. sortOrder jiné než 1 spolu s main = 1 (nebo 1 spolu s main = 0) je chyba a inzerát se nezpracuje. Neplatná hodnota (jiná než celé číslo od 1) se ignoruje a v odpovědi přijde warning.		 ✔          
photo/width Šířka fotky px integer              
photo/height Výška fotky px integer              
photo/stamp Stamp změny fotky char 128 V exportu obsahuje datetime poslední změny
V importu lze používat libovolný text.		 ✔          
videos@ignoreimport Neimportovat videa logical Používá se pouze u importu. Možné hodnoty:
  • true
  • false
 ✔          
videos@forceupdate Přepsat videa logical Používá se pouze u importu. Možné hodnoty:
  • true
  • false
 ✔          
video/status Stav zpracování select Možné hodnoty
  • OK
  • Chyba
  • Zpracováváno
            
video/statusChyba Chyba při zpracování string 255 Je-li video/status == Chyba, pak obsahuje textový popis chyby            
video/stamp Stamp změny videa char 128 V exportu obsahuje datetime poslední změny
V importu lze používat libovolný text.		 ✔          
video/delkaSec Délka videa integer Délka videa v sekundách            
video/nahled Náhled string 255 URL náhledového obrázku            
video/sources Videa element Jednotlivá videa v různých rozlišeních            
video/source/res Rozlišení select Typ rozlišení videa.
Možné hodnoty:
  • 180p
  • 270p
  • 406p
  • 720p
  • 1080p
            
video/source/url URL string 255 URL adresa daného rozlišení            
video/source/width Šířka integer Šířka videa v px            
video/source/height Výška integer Výška videa v px            
video/originalUrl Původní URL string 1024 Bylo-li video kopírováno z URL, je zde odkaz, ze kterého bylo kopírováno ✔          
video/originalFile Původní soubor string 255 Podařilo-li se zkopírovat video, je zde originální video, které je následně překódováno.            
userValue/nazevApp Název už. hodnoty string 255 Název uživatelské hodnoty pro aplikaci. ✔          
userValue/nazevApp@id ID už. hodnoty integer ID uživatelské hodnoty ✔          
userValue/hodnota Uživ. hodnota text Hodnota ✔          
stats Statistiky inzerátu element Celoživotní čítače inzerátu (očištěno o roboty apod.) – tentýž blok jako v archivu. Jen v detailu full a custom:stats, ve výpisu i v detailu záznamu. Blok nevyžaduje právo statsperm – stačí právo, se kterým login záznam čte.            
stats@ref Podrobná statistika href Odkaz na podrobnou statistiku inzerátu po dnech (podagenda stats). Ta vyžaduje právo statsperm, bez něj vrátí 402.            
stats/zobrazeni Počet zobrazení inzerátu integer              
stats/odpovedi Počet odpovědí ve formuláři u inzerátu integer              
stats/urlKliknuti Počet kliknutí na URL produktu integer              

rw = lze zapisovat
iu = lze použít ignoreonupdate
P = povinná položka
S = dle položky lze filtrovat a řadit
➀ = je v detailu id
➁ = je v detailu summary

TipMoto.com Kontaktujte nás