globalwordnet / OMW

The Open Multilingual Wordnet
http://compling.hss.ntu.edu.sg/omw/
MIT License
58 stars 9 forks source link

There is no RESTFUL api #81

Open fcbond opened 4 years ago

fcbond commented 4 years ago

Currently we do not serve a useful restful interface.

We should aim to be compatible with the interface of the English Wordnet, which basically serves a small wordnet, with all relevant synsets (including lemmas). So if you ask for lemma 'cat' you get all synsets that include 'cat' if you ask for '0123457-n' you get that synset and all it senses and so on.

See https://github.com/jmccrae/wordnet-angular for some sample templates. Here for an example: See https://github.com/jmccrae/wordnet-angular for some sample templates.

fcbond commented 4 years ago

Maybe something like this: http:// omw/xml/lemma/en/[lemma] http:// omw/xml/lili/[ili-id] http:// omw/xml/concept/[omw-id]

goodmami commented 4 years ago

maybe instead:

http://$domain/omw/lemma/en/<lemma>.xml (or .json, or nothing but use headers)
http://$domain/omw/ili/<ili_id>
http://$domain/omw/concept/<omw_id>

This way the content type (xml or whatever) doesn't intervene inside the URL, so later we can get rid of it and not break our URLs.

jmccrae commented 4 years ago

We can document the API here:

https://app.swaggerhub.com/apis/jmccrae/OMW/1.0

jmccrae commented 4 years ago

Nicer version here: https://app.swaggerhub.com/apis-docs/jmccrae/OMW/1.0