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ä.
- 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.
- Valitse oikean yläkulman rataskuvake (Järjestelmäasetukset).
- Valitse Tilin asetukset.
- Valitse vasemmasta valikosta API käyttö.
- Valitse API-avaimet-kohdasta Uusi API-avain.
- 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ä.
- Valitse Käyttöoikeus: Vain luku tai Luku ja kirjoitus.
- Valitse Lisää.
- Kopioi avain ja säilytä se turvallisessa paikassa. Et näe sitä enää myöhemmin.
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. 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.
- Valitse oikeasta yläkulmasta oma profiilikuvasi (Käyttäjäasetukset).
- Valitse Henkilökohtaiset API-avaimet.
- Valitse Uusi avain.
- Anna avaimelle nimi, esimerkiksi ”Claude Desktop”.
- Valitse Luo.
- Kopioi avain. Et näe sitä enää myöhemmin.
- Lisää tekoälyavustajaasi Sitedriven MCP-palvelin osoitteella
https://api.app.sitedrive.com/mcpja avaimellasi. Eri avustajien käyttöönotto-ohjeet ovat osoitteessa https://api.app.sitedrive.com/mcp/docs.
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.
- 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.