Page History

...

1. Rajapinnalle annetaan raakatekstiä. Jos dokumentti on muussa muodossa, esimerkiksi PDF-, HTML- tai Word-dokumenttina, se on ensin muunnettava UTF-8-merkistön mukaiseksi raakatekstiksi.
2. Rajapinnassa on tarjolla ns. projekteja ja rajapintakutsu pitää kohdistaa oikeaan projektiin dokumentin kielen mukaisesti. Jos dokumentin kieli ei ole tiedossa, se pitää ensin tunnistaa koneellisesti jollakin muulla työkalulla (kts. esim. SeCon LAS-rajapinta ja tai Pythonin pycld3- tai langdetect-kirjasto). Projekteja on tällä hetkellä kolme: yso-fi, yso-sv ja yso-en.
3. Rajapinnassa on useita metodeja, mutta niistä tärkeimmät ovat luettelo projekteista (/v1/projects/) sekä asiasanojen suosittelu (/v1/projects/<project_id>/suggest). Asiasanaehdotusten määrään voi vaikuttaa limit- ja threshold-parametreilla. Limit-parametri rajoittaa palautettavien ehdotusten määrää (oletusarvo 10) ja threshold asettaa vähimmäisrajan asiasanaehdotusten pistearvolle.
4. Rajapinnan käyttöä ei tällä hetkellä rajoiteta mitenkään. Jotta rajapinta ei ylikuormittuisi, vältä tekemästä useita rinnakkaisia rajapintakutsuja eli odota, että edellinen kutsu valmistuu ennen kuin teet uuden kutsun. Syöte voi olla kooltaan enintään 5 MB.

...