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

> API kľúč a dokumentácia API pre vývojára na export záznamov a synchronizáciu miest, projektov a inventára (integrácia, REST API).

Source: https://help.venzeo.com/sk/article/pripojenie-vasho-systemu-k-venzeo-cez-api
Language: sk
Updated: 2026-10-31

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](https://help.venzeo.com/sk/article/exportovanie-filtrovanych-zaznamov).