api.tipmoto.com » Dokumentace API » Referenční » Identifikátory

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.

TipMoto.com Kontaktujte nás