/lltk-restful

A RESTful API for lltk.

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

LLTK-RESTful

LLTK-RESTful is a RESTful API for the Language Learning Toolkit (LLTK). It is based on Flask and delivers JSON documents by default.

Examples

The API should be self-explanatory after you have had a look at the following examples:

  • IPA: curl -X GET "http://server:port/lltk/ipa/de/Garten"

  • Pluralization: curl -X GET "http://server:port/lltk/plural/nl/boom"

  • Definite/Indefinite articles: curl -X GET "http://server:port/lltk/articles/de/Katze"

  • For conjugation of verbs, try the following:

curl -X GET "http://server:port/lltk/conjugate/de/bauen"
curl -X GET "http://server:port/lltk/conjugate/de/past/bauen"
curl -X GET "http://server:port/lltk/conjugate/de/perfect/bauen"
  • Audiosamples: curl -X GET "http://server:port/lltk/audiosamples/it/mela?key=xxx"

  • Samples sentences: curl -X GET "http://server:port/lltk/textsamples/es/jardín"

  • For images, try the following:

curl -X GET "http://server:port/lltk/images/fr/souris"
curl -X GET "http://server:port/lltk/images/fr/souris?itype=clipart&isize=large"
curl -X GET "http://server:port/lltk/images/fr/souris?itype=lineart&isize=small"

To get some basic information about the backend you can GET /lltk/info.

Requirements

Please install the following Python packages: lltk, Flask. You can do that by running:

sudo pip install -r requirements/base.txt

If you are a developer, you should install everything from base.txt, extra.txt and development.txt.

License

GNU Affero General Public License (AGPL), see LICENSE.txt for further details.