# API ja tekoälyavustajien käyttö

Luo API-avaimia integraatioita varten, löydä API-dokumentaatio ja yhdistä tekoälyavustajia, kuten Claude, Sitedriveen.

Language: fi
Canonical: https://support.sitedrive.com/fi/kb/api-and-integrations

Sitedrivessa on REST API, jonka avulla muut järjestelmäsi voivat lukea ja päivittää aikataulutietoja. Voit esimerkiksi tuoda tehtävien statuksia laatujärjestelmästä tai hakea aikataulutietoja raportointiin. Voit myös yhdistää tekoälyavustajan, kuten Clauden, jotta se voi hakea ja luoda aikataulutietoja puolestasi. Tässä artikkelissa kerrotaan molemmista.

## Ennen kuin aloitat

-   Tilin **API-avaimien** luomiseen tarvitset **Tilin admin** -roolin. Katso [Roolit ja mitä kukin voi tehdä](https://support.sitedrive.com/fi/kb/roles).
-   Kuka tahansa voi yhdistää tekoälyavustajan omalla henkilökohtaisella API-avaimellaan. Avustaja voi tehdä vain sitä, mitä sinä itse voit tehdä.

## Luo API-avain

API-avaimet ovat suositeltu tapa todentaa integraatiot. Ne antavat suoran pääsyn rajapintaan ilman erillistä kirjautumisvaihetta.

1.  Valitse oikean yläkulman rataskuvake (**Järjestelmäasetukset**).
2.  Valitse **Tilin asetukset**.
3.  Valitse vasemmasta valikosta **API käyttö**.
4.  Valitse **API-avaimet**\-kohdasta **Uusi API-avain**.
5.  Valitse **Laajuus**:
    -   **Koko tili**: pääsy kaikkiin API-avaimia tukeviin päätepisteisiin koko tilillä.
    -   **Hankekohtainen**: pääsy valitsemiisi hankkeisiin. Etsi hankkeet **Etsi hankkeita...** -kentällä.
6.  Valitse **Käyttöoikeus**: **Vain luku** tai **Luku ja kirjoitus**.
7.  Valitse **Lisää**.
8.  Kopioi avain ja säilytä se turvallisessa paikassa. Et näe sitä enää myöhemmin.

![API käyttö -sivu, jossa ovat API-avaimet- ja Vanhat API-käyttäjät -osiot](https://support.sitedrive.com/media/help/guide/api-and-integrations/01-api-usage.webp)

**API-avaimet**\-taulukossa näkyy jokaisesta avaimesta **API-avain**, **Viimeksi käytetty** ja **Käyttöoikeus**. Jos haluat estää integraatiota käyttämästä avainta, poista avain taulukosta.

### Vanhat API-käyttäjät

**Vanhat API-käyttäjät** -osio on tarkoitettu vanhemmille integraatioille. Näillä käyttäjillä on pääsy koko tiliin, ne voivat vanhentua ja ne vaativat todennuksen käyttäjätunnuksella ja salasanalla. Valitse **Uusi API-käyttäjä** vain, jos jokin olemassa oleva integraatio vaatii sitä. Käytä kaikkeen uuteen API-avainta.

## Löydä API-dokumentaatio

API-dokumentaatiossa on lueteltu kaikki päätepisteet esimerkkeineen: [https://api.app.sitedrive.com/api/docs](https://api.app.sitedrive.com/api/docs). Myös **API käyttö** -sivulla on linkki siihen.

Muutama asia, jotka on hyvä tietää, kun rakennat integraatiota:

-   Lähetä avain pyynnön otsakkeessa muodossa `Authorization: Bearer <your API key>`.
-   **Vain luku** -avaimella voi vain lukea tietoja. **Luku ja kirjoitus** -avaimella voi myös luoda, muuttaa ja poistaa.
-   Kaikki päätepisteet eivät hyväksy API-avaimia. Dokumentaatiosta näet, mitkä hyväksyvät.
-   Kullakin avaimella voi tehdä enintään 15 pyyntöä 5 sekunnissa. Jos lähetät enemmän, API vastaa HTTP-koodilla 429, ja sinun kannattaa yrittää hetken päästä uudelleen.

Jos sivulla lukee, että API-käyttö on poistettu käytöstä, ota yhteyttä Sitedriven tukeen, niin se kytketään takaisin päälle.

## Yhdistä tekoälyavustaja

Sitedrivella on MCP-palvelin, jonka kautta tekoälyavustajat (MCP-asiakasohjelmat), kuten Claude, voivat yhdistää Sitedriveen ja toimia puolestasi. Avustaja voi esimerkiksi etsiä projekteja, sijainteja ja tiimejä, tehdä yhteenvetoja työpaketeista, listata aikataulupohjia sekä luoda uuden hankkeen ja aikataulun kuvailemasi suunnitelman pohjalta.

Avustaja yhdistetään henkilökohtaisella API-avaimella.

1.  Valitse oikeasta yläkulmasta oma profiilikuvasi (**Käyttäjäasetukset**).
2.  Valitse **Henkilökohtaiset API-avaimet**.
3.  Valitse **Uusi avain**.
4.  Anna avaimelle nimi, esimerkiksi ”Claude Desktop”.
5.  Valitse **Luo**.
6.  Kopioi avain. Et näe sitä enää myöhemmin.
7.  Lisää tekoälyavustajaasi Sitedriven MCP-palvelin osoitteella `https://api.app.sitedrive.com/mcp` ja avaimellasi. Eri avustajien käyttöönotto-ohjeet ovat osoitteessa [https://api.app.sitedrive.com/mcp/docs](https://api.app.sitedrive.com/mcp/docs).

![Henkilökohtaiset API-avaimet -ikkuna ja Uusi avain -painike](https://support.sitedrive.com/media/help/guide/api-and-integrations/02-personal-api-keys.webp)

Voit tarkistaa yhteyden toimivuuden kysymällä avustajalta, kuka olet Sitedrivessa.

Kuka tahansa avaimesi haltija voi tehdä kaiken, mitä sinäkin voit, joten säilytä avain turvallisesti. Jos avain on voinut päätyä vääriin käsiin tai et enää käytä sitä, valitse sen vierestä **Mitätöi**.

## Hyvä tietää

-   API-avaimet ja henkilökohtaiset API-avaimet näytetään vain kerran. Jos kadotat avaimen, luo uusi ja poista vanha.
-   Tekoälyavustaja toimii aina **sinun** oikeuksillasi. Jos sinulla on aikataulussa vain Raportoi-rooli, avustajakaan ei voi muuttaa suunnitelmaa. Tilin **Allow LLM capabilities** -asetus ei muuta tätä. Katso [Tilin asetukset](https://support.sitedrive.com/fi/kb/account-settings).
-   Kun avustaja luo hankkeen tai aikataulun, se luo tilillesi oikeaa dataa aivan kuin olisit tehnyt sen itse.
-   Pilvessä toimivat avustajat, kuten claude.ai, tarvitsevat yllä mainitun julkisen osoitteen; ne eivät tavoita paikallista osoitetta.
-   Muita tapoja saada tietoja ulos Sitedrivesta ovat esimerkiksi käyttäjälistojen **Vie Exceliin** -toiminto ja janakaavion vienti. Katso [Tulostaminen ja vienti](https://support.sitedrive.com/fi/kb/printing-and-exporting).

## Aiheeseen liittyvää

-   [Tilin asetukset](https://support.sitedrive.com/fi/kb/account-settings)
-   [Tilin käyttäjät](https://support.sitedrive.com/fi/kb/account-users)
-   [Roolit ja niiden oikeudet](https://support.sitedrive.com/fi/kb/roles)
-   [Tulostus ja vienti](https://support.sitedrive.com/fi/kb/printing-and-exporting)