ID záznamů
Každá agenda v REST-API má svoji vlastní řadu identifikátorů.
Interní identifikátory
Můžete používat interní identifikátory, tj. např.:
https://api.tipmoto.com/c/12345/moto/123456789.xml
Není-li záznam s nalezen, vrací se chyba HTTP 404 Not Found.
V případě, že jde o inzeráty (agendy moto
, dily
, prislusenstvi
) a inzerát byl již smazán, vrací se HTTP 410 Gone
Externí identifikátory
Při používání REST-API ve WRITE režimu doporučujeme zasílat i své identifikátory a nemusíte tak používat naše interní identifikátory pro inzeráty.
Tyto identifikátory lze využít pouze v agendách moto
, dily
, prislusenstvi
Identifikátor musí být unikátní v rámci kombinace dané agendy a firmy.
K záznamů pak lze takto přistupovat pomocí předpony api-
, jeli-např. externí identifikátor ABC123
, přistupuje se pak k němu:
https://api.tipmoto.com/c/123/moto/api-ABC123.xml
Pozor na správné enkódování externího identifikátoru do URL adresy!
Tyto identifikátory se vypisují jako položka idApi
a přes editaci záznamu lze externí identifikátor upravit, popř. smazat.
Není-li záznam s externím identifikátorem nalezen, vrací se chyba HTTP 404 Not Found.