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

> Získejte API klíč a dokumentaci pro vývojáře k exportu záznamů a synchronizaci míst zájmu, projektů a inventáře.

Source: https://help.venzeo.com/cs/article/pripojeni-vaseho-systemu-k-venzeo-pres-api
Language: cs
Updated: 2026-10-31

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ů](https://help.venzeo.com/cs/article/exportovani-filtrovanych-zaznamu).