Agenda dily
Contains parts ads
Sub-agendas overview
| Name | Machine name | WRITE |
|---|---|---|
| Photos | photo |
YES |
| Price history | ceny |
NO |
| Statistics | stats |
NO |
Agenda features
| Name | Options |
|---|---|
| Supported methods | GET, PUT/POST, DELETE |
| Support for detail levels | ✔ |
| Support for filtering | ✔ |
| Support for full-text search | ✔ |
| Support for pagination | ✔ |
| Support for sorting | ✔ |
| Support for external identifiers | ✔ |
Support for schemas |
https://api.tipmoto.com/schemas/dily-{export|import}{-enum}.{xsd|rng} |
Support for ?fail-on-warning |
✔ |
| Support for dry-run | ✔ |
Returns location |
✔ |
Agenda elements
| Machine name | Name | Type | Information | rw | P | S | ➀ | ➁ |
|---|---|---|---|---|---|---|---|---|
id |
Ad ID in the agenda dily |
integer |
✔ | ✔ | ✔ | |||
idApi |
external ad ID | string 64 |
✔ | ✔ | ✔ | ✔ | ||
aktivni |
active | select |
Possible values:
|
✔ | ✔ | ✔ | ✔ | ✔ |
lastModified |
Last modified | datetime |
Format YYYY-MM-DD HH:MM:SS |
✔ | ✔ | ✔ | ✔ | ✔ |
pobocka |
Branch | string 128 |
Shown and processed only if the dealer has more than one branch | ✔ | ✔ | |||
pobocka@id |
Branch ID | integer |
Shown and processed only if the dealer has more than one branch | ✔ | ✔ | ✔ | ✔ | |
kontakt |
Contact | element |
Contact of the ad – phones, e-mail and website shown with the ad instead of the branch details (the address, seller name and opening hours remain those of the branch). The dealer's contacts are in the agenda kontakt.Shown only for dealers with at least one contact, then with every ad (including id="0"). The ref attribute links to the contact; it is missing for id="0". |
✔ | ||||
kontakt@id |
Contact ID | integer |
0 = default contact of the branch, otherwise the ID of a contact of the same dealer. A contact the dealer does not have (e.g. a deleted one) is output as 0.Writing <kontakt id="N"/>: without the element or with an empty id the contact is not changed, a new ad gets 0. A non-numeric ID returns the error “Invalid contact ID '…'”, a non-existent contact or a contact of another dealer returns the error “Dealer '…' has no contact id '…'”. |
✔ | ✔ | ✔ | ||
nazev |
Part name | string 64 |
✔ | ✔ | ✔ | ✔ | ||
branddily |
Brand | string 64 |
The brand can be imported as text This information is only supplementary The brand comes from the agenda branddily |
✔ | ✔ | ✔ | ||
branddily@id |
Brand ID | integer |
On import, the ID takes precedence over the text | ✔ | ✔ | ✔ | ||
zarazenidily |
Category | integer |
The category comes from the agenda zarazenidily |
✔ | ✔ | ✔ | ✔ | |
zarazenidily@moto |
Category parameters | integer |
On import, the category can also be specified as text We recommend using the ID; for backward compatibility it can also be given as text |
✔ | ✔ | ✔ | ✔ | |
zarazenidily@parentId |
Parent category ID | integer |
Not output in import/export, but records can be filtered and sorted by this value | ✔ | ||||
partnumber |
Part number | string 64 |
✔ | ✔ | ||||
nove |
New | select |
Possible values:
|
✔ | ✔ | ✔ | ||
cena |
Price | integer |
Value 0 = price negotiable (this is not allowed for new parts) |
✔ | ✔ | ✔ | ||
cena@historie |
Price history | href |
Link to the price history (sub-agenda ceny) |
|||||
cenaMena |
Currency | string 8 |
In practice it takes these values:
|
✔ | ✔ | ✔ | ||
dph |
VAT deductible | select |
Possible values:
|
✔ | ✔ | ✔ | ||
dostupnostdily |
Availability | integer |
The availability comes from the agenda dostupnostdily |
✔ | ✔ | ✔ | ||
puvoddily |
Origin | select |
The origin comes from the agenda puvoddily |
✔ | ✔ | ✔ | ||
poznamkaInterni |
Internal note | string 64 |
✔ | ✔ | ||||
akce |
Special offer | select |
Possible values:
|
✔ | ✔ | ✔ | ||
url |
URL on the dealer's website | string 255 |
✔ | |||||
youtube |
Youtube video | string 255 |
✔ | |||||
vlozeniCas |
Insertion time | datetime |
Format YYYY-MM-DD HH:MM:SS |
✔ | ||||
editaceCas |
Time of the last update | datetime |
Format YYYY-MM-DD HH:MM:SS, may be empty |
✔ | ||||
urlTipmoto |
URL on TipMoto.com | string 255 |
||||||
urlTipmotoSubdomain |
URL on the subdomain | string 255 |
||||||
popis |
Description | text |
May contain HTML | ✔ | ||||
models |
Models | Either the models or the pneus structure must be given |
✔ | ✔ | ||||
model/id |
Motorcycle model | integer |
The model comes from the agenda model |
✔ | ✔ | |||
model/id@manufacturer |
Motorcycle model | string 64 |
On import, the model can also be specified as text We recommend using the ID; for backward compatibility it can also be given as text |
✔ | ✔ | |||
model/madeFrom |
Production from | integer 4 |
The year of manufacture of motorcycles from which the part is intended | ✔ | ||||
model/madeTo |
Production to | integer 4 |
If intended for a single model year, it must also be given, with the same value as madeFrom |
✔ | ||||
model/dodatek |
Model suffix | string 16 |
✔ | |||||
pneus |
Tyres | Either the models or the pneus structure must be given |
✔ | ✔ | ||||
pneu/sada |
Tyre position | select |
Not given for a single tyre Possible values:
|
✔ | ✔ | |||
pneu/brandpneu |
Tyre brand | string 32 |
The brand comes from the agenda brandpneu |
✔ | ✔ | |||
pneu/sirka |
Tyre width | integer |
Value in mm (60-350) | ✔ | ✔ | |||
pneu/vyska |
Tyre height | integer |
Tyre profile as a percentage of the width, i.e. the ratio of the tyre height to its width in per cent (40-100) | ✔ | ✔ | |||
pneu/rafek |
Tyre rim | integer |
Value in inches (7-30) | ✔ | ✔ | |||
pneu/vzorek |
Tyre tread | string 32 |
✔ | ✔ | ||||
pneu/vzorekJednotka |
Tread unit | select |
Possible values:
|
✔ | ✔ | |||
pneu/dodatek |
Name suffix | string 32 |
✔ | |||||
photos@ignoreimport |
Do not import photos | logical |
Used only for import. Possible values:
|
✔ | ||||
photos@forceupdate |
Overwrite photos | logical |
Used only for import. Possible values:
|
✔ | ||||
photos@reorder |
Sort photos by the import | logical |
Used only for import. Possible values:
|
✔ | ||||
photo@modify |
Photo modification | select |
Used only for import. Possible values:
|
✔ | ||||
photo/id |
Photo ID | integer |
Refers to the agenda photo | |||||
photo/url |
Photo URL | string 255 |
✔ | |||||
photo/main |
Main photo | select |
Possible values:
0 or 1.Without main, the import does not change the main photo (for an ad without photos, the first photo is the main one; the exception when the main photo is deleted is described in Order and main photo). If several photos have main = 1, the first of them applies.An invalid value is ignored and the response contains a warning, so with ?fail-on-warning the ad is not processed. |
✔ | ||||
photo/sortOrder |
Photo order | integer |
Position of the photo in the ad gallery, 1 = main photo.On export, it is the position at which the website shows the photo. On import optional: the absolute position at which the photo is placed; the other photos fill the remaining positions. A number greater than the number of photos means the end of the gallery. sortOrder other than 1 together with main = 1 (or 1 together with main = 0) is an error and the ad is not processed. An invalid value (other than a whole number from 1) is ignored and the response contains a warning. |
✔ | ||||
photo/width |
Photo width px | integer |
||||||
photo/height |
Photo height px | integer |
||||||
photo/stamp |
Photo change stamp | char 128 |
In export it contains the datetime of the last changeIn import any text can be used. |
✔ | ||||
userValue/nazevApp |
User value name | string 255 |
Name of the user value for the application. | ✔ | ||||
userValue/nazevApp@id |
User value ID | integer |
User value ID | ✔ | ||||
userValue/hodnota |
User value | text |
Value | ✔ | ||||
stats |
Ad statistics | element |
Lifetime counters of the ad (cleaned of bots etc.) – the same block as in the archive. Only in detail levels full and custom:stats, in the record list and in the record detail. The block does not require the statsperm permission – the permission with which the login reads the record is enough. |
|||||
stats@ref |
Detailed statistics | href |
Link to the detailed statistics of the ad by day (sub-agenda stats). They require the statsperm permission and return 402 without it. |
|||||
stats/zobrazeni |
Number of ad views | integer |
||||||
stats/odpovedi |
Number of replies via the ad's form | integer |
||||||
stats/urlKliknuti |
Number of clicks on the product URL | integer |
rw = writable
P = required element
S = the element can be used for filtering and sorting
➀ = included in detail level id
➁ = included in detail level summary
