# Používejte přístup přes API

> Vytvářejte osobní přístupové tokeny pro skripty a klienty MCP a posílejte události ze svého prostoru Livespace do vlastních systémů pomocí webhooků.

V Nastavení › **Přístup přes API** můžete vytvářet osobní přístupové tokeny, aby skript nebo klient MCP mohl používat Dvina vaším jménem. Správci zde také přidávají webhooky, které posílají události z prostoru Livespace do jejich vlastních systémů.

Přístup přes API je součástí tarifu Enterprise. Každý člen může vytvářet vlastní tokeny; **Webhooky** vidí jen vlastníci a správci.

## Vytvořte token

1. Otevřete Nastavení a vyberte **Přístup přes API**.
2. V části **Osobní přístupové tokeny** vyberte **Vytvořit token**.
3. Zadejte **Název**, abyste později věděli, co token používá.
4. Vyberte **Přístup**: **Pouze čtení** nebo **Čtení a zápis**.
5. Vyberte, kdy **Vyprší platnost**: **Za 30 dní**, **Za 90 dní**, **Za 365 dní** nebo **Platnost nikdy nevyprší**.
6. Vyberte **Vytvořit token**.
7. V části **Zkopírujte si token** zkopírujte token a uložte ho na bezpečné místo. Zobrazí se pouze tentokrát.

Token jedná vaším jménem v prostoru Livespace, ve kterém jste ho vytvořili, a používá vaši aktuální roli v tomto prostoru. Token s přístupem **Pouze čtení** může číst, ale nemůže nic přidávat ani měnit.

Použití tokenu s klientem MCP popisuje část [Připojení pomocí klíče API místo OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Zkontrolujte, obměňte nebo odvolejte token

Vaše tokeny jsou uvedené v části **Osobní přístupové tokeny** spolu s úrovní přístupu. Vyberte token a podívejte se na údaje **Začíná na**, **Přístup**, **Poslední použití** a **Vyprší platnost**.

- **Pokud chcete token nahradit**, vyberte **Obměnit…** a potvrďte volbou **Obměnit**. Nahradí ho nový token a starý okamžitě přestane fungovat. Nový token zkopírujte v části **Zkopírujte si token**.
- **Pokud chcete token zneplatnit**, vyberte **Odvolat…** a potvrďte volbou **Odvolat**. Vše, co ho používá, okamžitě přestane fungovat.

Vytvoření, obměna a odvolání tokenu se zaznamenávají do [auditního protokolu](/docs/teams/audit-log).

## Přidejte webhook

Webhook posílá události z prostoru Livespace, tedy stejné záznamy jako v [auditním protokolu](/docs/teams/audit-log), na adresu, kterou zvolíte.

1. V Nastavení › **Přístup přes API** v části **Webhooky** vyberte **Přidat webhook**.
2. Zadejte **Název** a **URL**. Použijte veřejně dostupnou URL s HTTPS.
3. Pole **Události** nechte prázdné, pokud chcete posílat všechny události, nebo uveďte akce a oblasti, například `member.added` nebo `sharing.*`.
4. Vyberte **Přidat**.
5. V části **Zkopírujte si tajný klíč pro podepisování** zkopírujte tajný klíč. Zobrazí se pouze tentokrát.

Pokud Dvina zobrazí zprávu **Tato adresa není z Dvina dostupná**, použijte veřejně dostupnou URL s HTTPS.

### Ověřte podpis každého požadavku

Dvina posílá události v dávkách ve formátu JSON a každý požadavek podepisuje. Pomocí tajného klíče pro podepisování ověřte, že požadavek přišel z Dvina:

- Každý požadavek má hlavičku `X-Dvina-Signature` ve tvaru `t=<timestamp>,v1=<signature>`.
- Podpis je HMAC-SHA256 v šestnáctkovém zápisu, vypočítaný z časového razítka, tečky a těla požadavku pomocí vašeho tajného klíče pro podepisování.
- Vypočítejte podpis sami a porovnejte ho. Odmítněte požadavek, jehož podpis se neshoduje nebo jehož časové razítko je příliš staré.

## Kontrola nebo změna webhooku

Webhooky najdete v části **Webhooky** s jejich stavem: **Zapnuto**, **Pozastaveno** nebo **Selhává**. Vyberte webhook a zobrazte jeho podrobnosti.

- **Pokud ho chcete změnit**, upravte **Název**, **URL** nebo **Události** a pak vyberte **Uložit**.
- **Pokud ho chcete pozastavit**, vypněte **Odesílat události**. Opětovným zapnutím odesílání obnovíte.
- **Pokud chcete zjistit, jak funguje**, zkontrolujte jeho **Stav** a počet událostí v poli **Odesláno**. U selhávajícího webhooku se zobrazuje **Poslední chyba**. Dvina odesílání dál zkouší a zaznamenává selhání do protokolu auditu.
- **Pokud chcete změnit jeho tajný klíč**, vyberte **Nový podpisový tajný klíč…** a pak změnu potvrďte. Požadavky se okamžitě začnou podepisovat novým tajným klíčem, proto hned aktualizujte příjemce.
- **Pokud ho chcete odstranit**, vyberte **Smazat…** a pak potvrďte výběrem **Smazat**. Nic dalšího se do něj už neodešle.

## Související

- [Používání Dvina z jiných aplikací pomocí MCP](/docs/dvina-mcp/overview)
- [Používání protokolu auditu](/docs/teams/audit-log)
- [Přehled týmů](/docs/teams/overview)