Prijavi

Dostop prek API-ja

Po številnih podatkih tega spletnega mesta je mogoče neposredno povpraševati prek HTTP-vmesnika. Trenutno je podprto neposredno iskanje sopomenk, podobno črkovanih besed in podbesed. Zaenkrat še ni podprto iskanje po Wikipediji/Wiktionaryju.

Opozorilo: izhodni zapis se utegne še spremeniti. Vendar pa bo le razširjen, obstoječi deli ne bodo spremenjeni brez obvestila.

Povpraševanje

Z naslednjim HTTP-povpraševanjem prek GET lahko poiščete vse množice sopomenk, ki vsebujejo besedo veselje.

http://193.2.66.133:85/xml_api.php?q=veselje&format=text/xml

Rezultat

Rezultat povpraševanja je datoteka XML v naslednji obliki:

<matches>
  <metaData>
    <apiVersion content="0.1.2"/>
    <warning content="WARNING -- this API is in beta -- the format may change without warning!"/>
    <copyright content="Copyright (C) 2010 Martin Srebotnjak (www.tezaver.si)"/>
    <license content="GNU LESSER GENERAL PUBLIC LICENSE Version 2.1"/>
    <source content="http://www.tezaver.si"/>
    <date content="Tue Aug 10 21:54:43 CET 2010"/>
  </metaData>
  <synset id="1234">
    <categories>
      <category name="Ime kategorije"/>
    </categories>
    <term term="Pomen 1, beseda 1"/>
    <term term="Pomen 1, beseda 2"/>
  </synset>
  <synset id="2345">
    <categories/>
    <term term="Pomen 2, beseda 1"/>
  </synset>
</matches>

Možnosti

format=text/xml: odgovor bo vrnjen v zapisu XML. Drugi enostavno izvedljivi zapisi zaenkrat niso podprti.
similar=true: ob vsakem povpraševanju bo vrnjenih do pet podobnih besed. To je uporabno kot ponujanje predlogov uporabniku v primerih možnih tipkarskih napak. Primer povpraševanja:
```
http://193.2.66.133:85/xml_api.php?q=vesilje&format=text/xml&similar=true
```
Odgovor (odlomek):
```
<similarterms>
  <term term="veselje" distance="1"/>
  <term term="vesolje" distance="1"/>
  <term term="vesoljec" distance="2"/>
  <term term="vesti se" distance="3"/>
  <term term="vezilo" distance="3"/>
</similarterms>
```
distance povrne razdaljo Levenshtein do iskane besede (besede v narekovajih so ob tem prezrte). Besede so že razvrščene glede na ta pogoj. Predlagane so le besede, ki so na voljo v OdprtemTezavru. Ta funkcija torej ne služi tvorjenju predlogov pri preverjanju črkovanja.

substring=true: ob vsakem povpraševanju bo vrnjenih do deset zadetkov, ki vsebujejo iskani pojem kot podbesedo. Primer poizvedbe:

http://193.2.66.133:85/xml_api.php?q=roka&format=text/xml&substring=true

Odgovor (odlomek):

<substringterms>
  <term term="biserna poroka"/>
  <term term="diamantna poroka"/>
  <term term="oporoka"/>
  <term term="smerokaz"/>
  <term term="stroka"/>
</substringterms>

substringFromResults določa, s katerim vnosom zadetkov podbesed po vrsti naj se prične izpis zadetkov podbesed (odmik od prvega zadetka). Deluje le skupaj s substring=true. Privzeta vrednost je 0, torej s prvim zadetkom.
substringMaxResults določa največje število zadetkov podbesed, ki naj bodo vrnjeni. Deluje le skupaj s substring=true. Privzeta vrednost je 10, največja vrednost je 250.
mode=all: aktivira vsa dodatna povpraševanja. Doslej sta to le similar=true in substring=true.

Znane težave

Črke s preglasi se pri iskanju obravnavajo kot črke brez preglasa, tako z besedo tur najdete tudi vnos Tür in obratno. Kar pa za slovenski tezaver ni bistveno.

Prenos

Poleg neposrednega povpraševanja so še vedno na voljo tudi prenosi celotne zbirke podatkov.

Stran posodobljena: 2010-08-16

info @ tezaver.si