Pripojenie vášho systému k Venzeo cez API

Dokumentáciu API s API kľúčom môžu otvoriť iba administrátori.

Venzeo™ API prepája váš vlastný systém, napríklad ERP, GIS alebo evidenciu majetku, s Venzeo. Váš systém si môže sťahovať záznamy a udržiavať aktuálne miesta záujmu, projekty a inventár. API funguje pre každú aktívnu organizáciu. Prepojenie naprogramuje vývojár. Tu zistíte, čo mu máte odovzdať.

Príklad: Firma na zvoz odpadu každú noc kopíruje nové záznamy do svojho ERP a zoznam nádob aktualizuje zo svojej evidencie majetku.

Získanie API kľúča

1. Otvorte hlavné menu. Ak je zbalené, kliknite na Zobraziť menu.
2. Rozbaľte API pre vývojárov. Kým vaša organizácia API nepoužila, je táto časť na konci menu s označením Neaktívne.
3. Zvoľte Zobraziť dokumentáciu API. Dokumentácia sa otvorí na novej karte a API kľúč vašej organizácie je v nej už nastavený.
4. Na tejto stránke spustite požiadavku na export záznamov.
5. V príklade curl pre túto požiadavku skopírujte text za Authorization: Bearer. To je váš API kľúč.

Upozornenie: S API kľúčom zaobchádzajte ako s heslom. Ktokoľvek s ním môže čítať vaše záznamy a vytvárať, meniť a deaktivovať vaše miesta záujmu, projekty a inventár. Ak kľúč unikne, okamžite napíšte na support@venzeo.com.

Čo poslať vývojárovi

• Verejnú dokumentáciu API: https://api-external-eu.venzeo.com/docs/external/d41d8cd98f00b204e9800998ecf8427e/. Otvorí sa bez prihlásenia. Návod na jej začiatku popisuje bežné postupy a chybové kódy.
• API kľúč, samostatne a bezpečnou cestou.
• Ktoré údaje smie prepojenie čítať alebo meniť, napríklad iba záznamy, alebo aj miesta záujmu.

Na čo vývojári často zabúdajú

• Časy sú Unix časové značky v milisekundách.
• Polia bez hodnoty sa v odpovedi vynechajú, neposielajú sa ako null.
• Keď POST odpovie 409, záznam už existuje, preto pošlite PUT.

Ak chcete exportovať záznamy bez programovania, pozrite si Exportovanie filtrovaných záznamov.