KihoApi API-avainten hallinta
Yritys voi luoda itse tarvittavat Api-avaimet Kihon käyttöliittymässä, eikä niiden luonti vaadi palvelupyyntöä Kihon tuotekehitykseen.
Tunnusten luonnin vaiheet:
- Luodaan API-käyttäjä.
- Kihossa tämä on tavallinen käyttäjä. Rajapinnassa näkyvät tiedot noudattavat kyseiselle käyttäjälle määritettyjä näkyvyyksiä ja oikeuksia.
- Apikäyttäjälle määritetään esimerkiksi:
- Tiimi, jonka perusteella määrittyvät työmaiden ja kaluston näkyvyydet rajapinnassa.
- Käyttäjälle voidaan asettaa kalustoa myös käyttäjäprofiilissa (käyttäjä > ajoneuvot), mutta suositeltava tapa on tiimien hyödyntäminen.
- Rooli, jonka perusteella määrittyvät esimerkiksi rajapinnan oikeudet (kuten eri toimintojen tarkastelu, muokkaus ja poisto-oikeudet).
- Tunnusten luontiin käyttäjällä pitää olla oikeus "Salli hallita API-avaimia"
- Tunnusten luonti tapahtuu Yrityksen asetukset > Yleiset > Kirjautumisasetukset
- Valitse "lisää uusi", nimeä API-avain ja valitse API-käyttäjä, johon avain liitetään. Klikkaa Tallenna.
Kopioi API-avain talteen tietoturvalliseen sijaintiin. Huom! API-avainta ei ole mahdollista noutaa enää tämän vaiheen jälkeen. Jos avain hukkuu tai et tallentanut sitä, on luotava uusi avain.
KihoApi:n dokumentaatio löytyy osoitteesta https://developers.kiho.fi/api/