# Korzystaj z dostępu do API

> Twórz osobiste tokeny dostępu dla skryptów i klientów MCP oraz wysyłaj zdarzenia ze swojej przestrzeni Livespace do własnych systemów za pomocą webhooków.

W Ustawieniach › **Dostęp do API** możesz tworzyć osobiste tokeny dostępu, dzięki którym skrypt lub klient MCP może korzystać z Dvina w Twoim imieniu. Administratorzy mogą też dodawać tam webhooki, aby wysyłać zdarzenia z przestrzeni Livespace do własnych systemów.

Dostęp do API jest dostępny w planie Enterprise. Każdy członek może tworzyć własne tokeny; sekcję **Webhooki** widzą tylko właściciele i administratorzy.

## Utwórz token

1. Otwórz Ustawienia i wybierz **Dostęp do API**.
2. W sekcji **Osobiste tokeny dostępu** wybierz **Utwórz token**.
3. Wpisz **Nazwę**, aby później wiedzieć, co korzysta z tego tokenu.
4. Wybierz **Dostęp**: **Tylko odczyt** lub **Odczyt i zapis**.
5. Wybierz, kiedy token **Wygasa**: **Za 30 dni**, **Za 90 dni**, **Za 365 dni** lub **Nigdy nie wygasa**.
6. Wybierz **Utwórz token**.
7. W sekcji **Skopiuj swój token** skopiuj token i zachowaj go w bezpiecznym miejscu. Jest wyświetlany tylko ten jeden raz.

Token działa w Twoim imieniu w przestrzeni Livespace, w której został utworzony, zgodnie z Twoją obecną rolą w tej przestrzeni. Token z dostępem **Tylko odczyt** pozwala odczytywać dane, ale nie pozwala niczego dodawać ani zmieniać.

Aby użyć tokenu z klientem MCP, zobacz [Połącz się za pomocą klucza API zamiast OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Sprawdź, wymień lub unieważnij token

Twoje tokeny są wymienione w sekcji **Osobiste tokeny dostępu** wraz z zakresem dostępu. Wybierz token, aby sprawdzić, od czego **Zaczyna się**, jaki ma **Dostęp**, kiedy był **Ostatnio używany** i kiedy **Wygasa**.

- **Aby wymienić token**, wybierz **Wymień…**, a następnie **Wymień**, aby potwierdzić. Nowy token zastąpi dotychczasowy, a stary natychmiast przestanie działać. Skopiuj nowy token w sekcji **Skopiuj swój token**.
- **Aby unieważnić token**, wybierz **Unieważnij…**, a następnie **Unieważnij**, aby potwierdzić. Wszystko, co z niego korzysta, natychmiast przestanie działać.

Tworzenie, wymiana i unieważnianie tokenów są rejestrowane w [dzienniku audytu](/docs/teams/audit-log).

## Dodaj webhook

Webhook wysyła zdarzenia z przestrzeni Livespace — te same wpisy co w [dzienniku audytu](/docs/teams/audit-log) — na wybrany przez Ciebie adres.

1. W Ustawieniach › **Dostęp do API**, w sekcji **Webhooki**, wybierz **Dodaj webhook**.
2. Wpisz **Nazwę** i **URL**. Użyj publicznego adresu URL z protokołem HTTPS.
3. Pole **Zdarzenia** pozostaw puste, aby wysyłać wszystkie zdarzenia, lub podaj działania i obszary, takie jak `member.added` lub `sharing.*`.
4. Wybierz **Dodaj**.
5. W sekcji **Skopiuj klucz do podpisywania** skopiuj klucz. Jest wyświetlany tylko ten jeden raz.

Jeśli Dvina wyświetla komunikat **Ten adres jest niedostępny z Dvina**, użyj publicznego adresu URL z protokołem HTTPS.

### Sprawdzaj podpis każdego żądania

Dvina wysyła zdarzenia partiami w formacie JSON i podpisuje każde żądanie. Użyj klucza do podpisywania, aby sprawdzić, czy żądanie pochodzi z Dvina:

- Każde żądanie zawiera nagłówek `X-Dvina-Signature` w postaci `t=<timestamp>,v1=<signature>`.
- Podpis to zapisany szesnastkowo kod HMAC-SHA256 obliczony dla znacznika czasu, kropki i treści żądania przy użyciu Twojego klucza do podpisywania.
- Oblicz podpis samodzielnie i porównaj go z otrzymanym. Odrzuć żądanie, jeśli podpisy się nie zgadzają lub znacznik czasu jest zbyt stary.

## Sprawdź lub zmień webhook

Twoje webhooki są widoczne w sekcji **Webhooki** wraz ze statusem: **Włączony**, **Wstrzymany** lub **Błąd**. Wybierz webhook, aby zobaczyć jego szczegóły.

- **Aby go zmienić**, edytuj **Nazwę**, **URL** lub **Zdarzenia**, a następnie wybierz **Zapisz**.
- **Aby go wstrzymać**, wyłącz opcję **Wysyłaj zdarzenia**. Włącz ją ponownie, aby wznowić wysyłanie.
- **Aby sprawdzić, jak działa**, sprawdź jego **Status** i liczbę zdarzeń oznaczonych jako **Wysłane**. Webhook ze statusem błędu pokazuje **Ostatni błąd**. Dvina ponawia próby i zapisuje niepowodzenie w dzienniku audytu.
- **Aby zmienić jego sekret**, wybierz **Nowy sekret podpisywania…**, a następnie potwierdź. Żądania są od razu podpisywane nowym sekretem, więc natychmiast zaktualizuj konfigurację odbiorcy.
- **Aby go usunąć**, wybierz **Usuń…**, a następnie **Usuń**, aby potwierdzić. Nic więcej nie będzie do niego wysyłane.

## Powiązane

- [Korzystaj z Dvina w innych aplikacjach za pomocą MCP](/docs/dvina-mcp/overview)
- [Korzystaj z dziennika audytu](/docs/teams/audit-log)
- [Przegląd zespołów](/docs/teams/overview)