# Käytä API-yhteyttä

> Luo henkilökohtaisia käyttöoikeustunnuksia skripteille ja MCP-asiakkaille ja lähetä Livespacen tapahtumat omiin järjestelmiisi webhookien avulla.

Voit luoda henkilökohtaisia käyttöoikeustunnuksia kohdassa Asetukset › **API-käyttö**, jotta skripti tai MCP-asiakas voi käyttää Dvinaa puolestasi. Ylläpitäjät voivat myös lisätä siellä webhookeja, jotka lähettävät Livespacen tapahtumat heidän omiin järjestelmiinsä.

API-käyttö sisältyy Enterprise-tilaukseen. Jokainen jäsen voi luoda omia tunnuksiaan. Vain omistajat ja ylläpitäjät näkevät kohdan **Webhookit**.

## Luo tunnus

1. Avaa Asetukset ja valitse **API-käyttö**.
2. Valitse kohdassa **Henkilökohtaiset käyttöoikeustunnukset** vaihtoehto **Luo tunnus**.
3. Anna **Nimi**, josta tunnistat myöhemmin, mihin tunnusta käytetään.
4. Valitse **Käyttöoikeus**: **Vain luku** tai **Luku ja kirjoitus**.
5. Valitse, milloin tunnus **Vanhenee**: **30 päivän kuluttua**, **90 päivän kuluttua**, **365 päivän kuluttua** tai **Ei vanhene koskaan**.
6. Valitse **Luo tunnus**.
7. Kopioi tunnus kohdasta **Kopioi tunnuksesi** ja säilytä se turvallisessa paikassa. Tunnus näytetään vain tämän kerran.

Tunnus toimii puolestasi siinä Livespacessa, jossa loit sen, ja käyttää nykyisen roolisi oikeuksia kyseisessä Livespacessa. **Vain luku** -tunnuksella voi lukea tietoja, mutta ei lisätä tai muuttaa mitään.

Jos haluat käyttää tunnusta MCP-asiakkaan kanssa, katso [Yhdistä API-avaimella OAuthin sijaan](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Tarkista, uusi tai peruuta tunnus

Tunnuksesi ja niiden käyttöoikeudet näkyvät kohdassa **Henkilökohtaiset käyttöoikeustunnukset**. Valitse tunnus, niin näet sen **Alkumerkit** ja **Käyttöoikeuden** sekä sen, milloin tunnusta on **Käytetty viimeksi** ja milloin se **Vanhenee**.

- **Voit korvata tunnuksen** valitsemalla **Uusi…** ja vahvistamalla valinnan painamalla **Uusi**. Uusi tunnus korvaa vanhan, ja vanha lakkaa toimimasta heti. Kopioi uusi tunnus kohdasta **Kopioi tunnuksesi**.
- **Voit poistaa tunnuksen käytöstä** valitsemalla **Peruuta…** ja vahvistamalla valinnan painamalla **Peruuta**. Kaikki tunnusta käyttävät yhteydet lakkaavat toimimasta heti.

Tunnuksen luominen, uusiminen ja peruuttaminen kirjataan [valvontalokiin](/docs/teams/audit-log).

## Lisää webhook

Webhook lähettää Livespacen tapahtumat valitsemaasi osoitteeseen. Tapahtumat ovat samoja tietueita kuin [valvontalokissa](/docs/teams/audit-log).

1. Valitse kohdassa Asetukset › **API-käyttö** › **Webhookit** vaihtoehto **Lisää webhook**.
2. Anna **Nimi** ja **URL**. Käytä julkista HTTPS-osoitetta.
3. Jätä **Tapahtumat**-kenttä tyhjäksi, jos haluat kaikki tapahtumat, tai luettele toiminnot ja alueet, kuten `member.added` tai `sharing.*`.
4. Valitse **Lisää**.
5. Kopioi salainen avain kohdasta **Kopioi allekirjoituksen salainen avain**. Avain näytetään vain tämän kerran.

Jos Dvina ilmoittaa **Tätä osoitetta ei voi tavoittaa Dvinasta**, käytä julkista HTTPS-osoitetta.

### Tarkista jokaisen pyynnön allekirjoitus

Dvina lähettää tapahtumat erissä JSON-muodossa ja allekirjoittaa jokaisen pyynnön. Tarkista allekirjoituksen salaisella avaimella, että pyyntö on tullut Dvinasta:

- Jokaisessa pyynnössä on `X-Dvina-Signature`-otsake, jonka muoto on `t=<timestamp>,v1=<signature>`.
- Allekirjoitus on heksadesimaalimuotoinen HMAC-SHA256, joka lasketaan aikaleimasta, pisteestä ja pyynnön rungosta käyttäen allekirjoituksen salaista avaintasi.
- Laske allekirjoitus itse ja vertaa sitä pyynnön allekirjoitukseen. Hylkää pyyntö, jos allekirjoitukset eivät täsmää tai aikaleima on liian vanha.

## Tarkista webhook tai muuta sitä

Webhookit näkyvät kohdassa **Webhookit**, ja niiden tila on **Käytössä**, **Keskeytetty** tai **Virhetilassa**. Valitse webhook, niin näet sen tiedot.

- **Jos haluat muuttaa webhookia**, muokkaa sen **Nimeä**, **URL-osoitetta** tai **Tapahtumia** ja valitse **Tallenna**.
- **Jos haluat keskeyttää lähettämisen**, poista **Lähetä tapahtumat** käytöstä. Ota se uudelleen käyttöön, kun haluat jatkaa lähettämistä.
- **Jos haluat tarkistaa webhookin toiminnan**, katso sen **Tila** ja **Lähetetty**-tapahtumien määrä. Virhetilassa olevan webhookin tiedoissa näkyy **Viimeisin virhe**. Dvina jatkaa lähetysyrityksiä ja kirjaa epäonnistumisen auditointilokiin.
- **Jos haluat vaihtaa webhookin salaisuuden**, valitse **Uusi allekirjoitussalaisuus…** ja vahvista. Pyynnöt allekirjoitetaan heti uudella salaisuudella, joten päivitä vastaanottaja saman tien.
- **Jos haluat poistaa webhookin**, valitse **Poista…** ja vahvista valitsemalla **Poista**. Webhookiin ei enää lähetetä mitään.

## Aiheeseen liittyvää

- [Käytä Dvinaa muista sovelluksista MCP:n avulla](/docs/dvina-mcp/overview)
- [Käytä auditointilokia](/docs/teams/audit-log)
- [Tiimien yleiskatsaus](/docs/teams/overview)