Připojení vašeho systému k Venzeo přes API

Pouze správci mohou otevřít dokumentaci API s API klíčem.

Rozhraní Venzeo™ API propojí váš vlastní systém, jako je ERP, GIS nebo evidence majetku, s Venzeo. Váš systém může stahovat záznamy a udržovat místa zájmu, projekty a inventář aktuální. API funguje pro každou aktivní organizaci. Propojení vytvoří vývojář. Tato stránka vám ukáže, co mu předat.

Příklad: Svozová společnost každou noc kopíruje nové záznamy do svého ERP a aktualizuje seznam popelnic ze své evidence inventáře.

Získání API klíče

1. Otevřete hlavní menu. Pokud je sbalené, klikněte na Zobrazit menu.
2. Rozbalte API pro vývojáře. Dokud vaše organizace API nepoužije, je tato sekce na konci menu s označením Neaktivní.
3. Zvolte Zobrazit dokumentaci API. Dokumentace se otevře na nové kartě s již předvyplněným API klíčem vaší organizace.
4. Na této stránce spusťte požadavek na export záznamů.
5. V ukázce příkazu curl tohoto požadavku zkopírujte text za Authorization: Bearer. Toto je váš API klíč.

Varování: S API klíčem zacházejte jako s heslem. Kdokoli s ním může číst vaše záznamy a vytvářet, měnit i deaktivovat vaše místa zájmu, projekty a inventář. Pokud klíč unikne, okamžitě napište na support@venzeo.com.

Co předat vašemu vývojáři

• Veřejnou dokumentaci API: https://api-external-eu.venzeo.com/docs/external/d41d8cd98f00b204e9800998ecf8427e/. Otevře se bez přihlášení. Návod v horní části popisuje obvyklé pracovní postupy a chybové kódy.
• API klíč, a to samostatným, zabezpečeným kanálem.
• Která data smí propojení číst nebo měnit, například pouze záznamy, nebo i místa zájmu.

Na co vývojáři často zapomínají

• Časy jsou unixová časová razítka v milisekundách.
• Pole bez hodnoty se v odpovědi vynechávají, neposílají se jako null.
• Pokud POST odpoví 409, záznam již existuje, pošlete proto místo toho PUT.

Chcete-li záznamy exportovat bez programování, přečtěte si Export filtrovaných záznamů.