# Користите приступ API-ју

> Креирајте личне приступне токене за скрипте и MCP клијенте и шаљите догађаје из свог простора Livespace у сопствене системе помоћу веб-хукова.

У одељку Подешавања › **Приступ API-ју** креирате личне приступне токене да би скрипта или MCP клијент могли да користе Dvina у ваше име. Администратори ту додају и веб-хукове за слање догађаја из простора Livespace у сопствене системе.

Приступ API-ју је доступан у оквиру плана Enterprise. Сваки члан може да креира своје токене; само власници и администратори виде **Веб-хукове**.

## Креирајте токен

1. Отворите Подешавања и изаберите **Приступ API-ју**.
2. У одељку **Лични приступни токени** изаберите **Креирај токен**.
3. Унесите **Назив** да бисте касније знали шта га користи.
4. Изаберите **Приступ**: **Само читање** или **Читање и писање**.
5. Изаберите када **Истиче**: **За 30 дана**, **За 90 дана**, **За 365 дана** или **Никада не истиче**.
6. Изаберите **Креирај токен**.
7. У одељку **Копирајте свој токен** копирајте токен и сачувајте га на безбедном месту. Приказује се само овом приликом.

Токен ради у ваше име, у простору Livespace у ком сте га креирали, са вашом тренутном улогом у том простору. Токен са приступом **Само читање** може да чита, али не може ништа да додаје или мења.

Да бисте користили токен са MCP клијентом, погледајте [Повежите се помоћу API кључа уместо OAuth-а](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Проверите, замените или опозовите токен

Ваши токени су наведени у одељку **Лични приступни токени**, уз ниво приступа. Изаберите токен да бисте видели чиме **Почиње**, његов **Приступ**, када је **Последњи пут коришћен** и када **Истиче**.

- **Да бисте заменили токен**, изаберите **Замени…**, па **Замени** да бисте потврдили. Нови токен замењује стари, а стари одмах престаје да ради. Копирајте нови токен у одељку **Копирајте свој токен**.
- **Да бисте онемогућили токен**, изаберите **Опозови…**, па **Опозови** да бисте потврдили. Све што га користи одмах престаје да ради.

Креирање, замена и опозив токена бележе се у [дневнику ревизије](/docs/teams/audit-log).

## Додајте веб-хук

Веб-хук шаље догађаје из простора Livespace, односно исте записе као [дневник ревизије](/docs/teams/audit-log), на адресу коју изаберете.

1. У одељку Подешавања › **Приступ API-ју**, под **Веб-хукови**, изаберите **Додај веб-хук**.
2. Унесите **Назив** и **URL**. Користите јавно доступан HTTPS URL.
3. Поље **Догађаји** оставите празно за све догађаје или наведите радње и области, као што су `member.added` или `sharing.*`.
4. Изаберите **Додај**.
5. У одељку **Копирајте тајни кључ за потписивање** копирајте тајни кључ. Приказује се само овом приликом.

Ако Dvina прикаже поруку **Овој адреси није могуће приступити из сервиса Dvina**, користите јавно доступан HTTPS URL.

### Проверите потпис сваког захтева

Dvina шаље догађаје у групама, у JSON формату, и потписује сваки захтев. Користите тајни кључ за потписивање да бисте проверили да ли је захтев стигао из сервиса Dvina:

- Сваки захтев има заглавље `X-Dvina-Signature` у облику `t=<timestamp>,v1=<signature>`.
- Потпис је HMAC-SHA256 вредност у хексадецималном облику, израчуната на основу временске ознаке, тачке и тела захтева, помоћу вашег тајног кључа за потписивање.
- Израчунајте га сами и упоредите. Одбијте захтев ако се потпис не подудара или ако је временска ознака престара.

## Проверите или измените веб-хук

Ваши веб-хукови су наведени у одељку **Веб-хукови**, са статусом: **Укључен**, **Паузиран** или **Неуспешан**. Изаберите један да бисте видели његове детаље.

- **Да бисте га изменили**, уредите **Назив**, **URL** или **Догађаје**, па изаберите **Сачувај**.
- **Да бисте га паузирали**, искључите **Шаљи догађаје**. Поново укључите ову опцију да бисте наставили слање.
- **Да бисте проверили како ради**, погледајте његов **Статус** и број догађаја означених као **Послато**. Веб-хук који не успева да пошаље догађаје приказује **Последњу грешку**. Dvina наставља да покушава и бележи неуспех у евиденцији ревизије.
- **Да бисте променили његов тајни кључ**, изаберите **Нови тајни кључ за потписивање…**, па потврдите. Захтеви се одмах потписују новим тајним кључем, па одмах ажурирајте и примаоца.
- **Да бисте га уклонили**, изаберите **Избриши…**, па **Избриши** да бисте потврдили. Ништа му се више не шаље.

## Повезано

- [Користите Dvina из других апликација уз MCP](/docs/dvina-mcp/overview)
- [Користите евиденцију ревизије](/docs/teams/audit-log)
- [Преглед тимова](/docs/teams/overview)