Page History

Api.annif.org on uudistunut 17.1.2020! Uudistus vaikuttaa myös osoitteessa annif.org olevaan testilomakkeeseen, joka käyttää rajapintaa. Tähän tiedotteeseen on koottu yhteenveto muutoksista rajapinnan nykyisille käyttäjille.

Uudet algoritmit ja opetusaineistot

Otimme testirajapintapalvelu api.annif.org:issa käyttöön uusimman Annif-ohjelmistoversion sekä sen mukana tuomia uusia algoritmeja, mm. omikuji-algoritmit, jotka on koulutettu paljon entistä laajemmilla opetusaineistoilla. Parannusten pitäisi ennen kaikkea näkyä entistä osuvampina asiasanaehdotuksina. 

Uudempi YSO, jossa mukana myös YSO-paikat

Uudistuksen myötä YSO päivitettiin uudempaan versioon 2019.3 Cicero. Lisäksi mukana ovat nyt myös YSO-paikat, joten Annifin rajapintapalvelu voi ehdottaa myös paikannimiä aiheiksi. 

Rajapinnan tarjoamat projektit

Annifin rajapinnassa on tarjolla useita projekteja, jotka tukevat tiettyä sanastoa ja kieltä. Projektivalikoima pysyi edellisen kaltaisena, tosin pienin muutoksin, koska joidenkin projektien tausta-algoritmit vaihtuivat. Tarjolla ovat tällä hetkellä nämä projektit:

• yso-fi / yso-sv / yso-en: Yleisprojektit YSO:n käyttöön kolmella kielellä
• wikidata-en: Wikidata-aiheita englanninkielisen tekstin pohjalta ehdottava projekti
• hogwarts: Tylypahkan tupia nimen perusteella ehdottava projekti

Muutoksia rajapinnan metodinimissä

Annifin rajapinnan keskeisin metodi, jolle annetaan tekstiä ja joka ehdottaa aiheita, on alkuperäiseltä nimeltään “analyze”. Tämän nimen kuitenkin todettiin olevan harhaanjohtava ja nykyisin metodi tunnetaan nimellä “suggest”. Suosittelemme sovellusten siirtyvän käyttämään uutta metodinimeä. Vanhakin nimi kuitenkin toimii jatkossakin, vaikka sitä ei uudistuksen jälkeen enää mainita rajapinnan dokumentaatiossa.

Annif-prototyypin rajapinta v0 poistui käytöstä

Osoitteessa api.annif.org/v0/ on ollut jo vuoden 2017 keväästä asti tarjolla Annifin alkuperäisen prototyypin rajapinta, joka poistui käytöstä rajapintauudistuksen myötä.

HTTPS-protokolla tarjolla

Rajapinta api.annif.org toimii nyt HTTP-protokollan lisäksi myös suojatulla HTTPS-yhteydellä.

Tulevaisuuden näkymiä

Rajapintaan on suunniteltu lisättäväksi myös uusi learn-metodi, jota voidaan käyttää Annifin opettamiseen esimerkiksi sen jälkeen, kun kuvailija on tarkistanut Annifin ehdottamat aiheet ja korjaillut niitä. Tämän metodin käyttö testirajapinnassa ei tässä vaiheessa kuitenkaan ole sallittua, koska haluamme ensin selvittää huolellisesti, miten palautteesta oppiminen käytännössä vaikuttaa Annifin ehdotusten laatuun ja sitten päättää, miten laajaan käyttöön learn-metodi voidaan avata.

Seuraava YSO:n jäädytetty versio julkaistaan alkukeväästä 2020 ja Annifin rajapintapalvelukin siirtyy aikanaan käyttämään sitä. Tästä tiedotetaan erikseen.

Testirajapinnan uudistus on ensimmäinen askel kohti tavoitettamme tarjota tuotantokäyttöön soveltuva automaattisen sisällönkuvailun rajapinta Finton rajapinnan tämän kevään aikana. Tekniikaltaan uusi rajapinta tulee olemaan lähes identtinen api.annif.org-testirajapinnan kanssa, mutta se on tarkoitettu tuotantokäyttöön ja tarjolla on vain rajallinen joukko projekteja, ensi vaiheessa YSO:lle (kolmella kielellä) mutta tulevaisuudessa myös muille sanastoille. Uudesta rajapinnasta tiedotetaan erikseen ja sen käyttöön tullaan tarjoamaan tarkempaa ohjeistusta ja tukipalveluja.