Record IDs

Each agenda in the REST API has its own series of identifiers.

Internal identifiers

You can use internal identifiers, i.e. e.g.:

https://api.tipmoto.com/c/12345/moto/123456789.xml

If the record is not found, the error HTTP 404 Not Found is returned.
In the case of ads (agendas moto, dily, prislusenstvi), if the ad has already been deleted, HTTP 410 Gone is returned

External identifiers

When using the REST API in WRITE mode, we recommend sending your own identifiers as well, so you do not have to use our internal identifiers for ads.
These identifiers can only be used in the agendas moto, dily, prislusenstvi
The identifier must be unique within the combination of the given agenda and dealer.

Records can then be accessed using the prefix api-; e.g. if the external identifier is ABC123, it is accessed as:

https://api.tipmoto.com/c/123/moto/api-ABC123.xml

Take care to encode the external identifier correctly in the URL.

These identifiers are listed as the element idApi, and the external identifier can be changed or deleted by updating the record.
If a record with the external identifier is not found, the error HTTP 404 Not Found is returned.