hall / interkonekto

defini e tradukuri di vortari en Ido

interkonekto

The API at https://api.linguo.io returns (in the JSON format) data of words in the Ido language.

Warning

This project is very unstable and will change frequently until it has time to mature. If you experience issues, please notify the administrator at [e-mail].

A simple front end is being co-developed here: https://github.com/linguo-io/vortaro

format

Requests are constructed in the following manner:

https://api.linguo.io/query/data

query

Preceding the query with an ISO language code, followed by a colon, will treat the query as being written in that language.

Warning

The following feature is not currently available:

If the query is preceded by a tilde, it is interpreted as a regular expression.

data

The data options are:

semantiko	definitions
exemplaro	a few examples of usage
sinonimo	words with similar meanings
kompundi	compound forms
kategorio	associated categories
an ISO language code	en,es,zh,…​

Note	The special request https://api.linguo.io/* will return a list of the available data options.

Multiple selections are made by delimiting options with a coma. If no data options are requested, all of them are returned (for matched queries).

action

The usual HTTP methods will not surprise you.

• GET: lektar

Warning

The following are not yet implemented:

• PUT: skribar nova informeso

PUT https://api.linguo.io/linguo semantiko='something or another about language.'

{
  "lingu.o": {
    "semantiko": "something or another about language."
  }
}

• POST: krear

• DELETE: efacar

examples

To return the definition of linguo, with example usage:

GET https://api.linguo.io/linguo/semantiko,exemplaro

{
  "lingu.o": {
    "exemplaro": [
      "matrala linguo"
      "intermixo di lingui",
    ],
    "semantiko": "Vortaro e sintaxo propra a komuneso."
  }
}

To return matches of the Russian word язык:

GET https://api.linguo.io/ru:язык

{
  "lingu.o": {
    ...
    "io": "linguo",
    ...
    "ru": "язык",
    ...
  }
}

To return the English translation of every word that begins with vort:

GET https://api.linguo.io/~^vort.*/en

{
  "vortala": {
    "en": "verbal"
  },
  "vortifo": {
    "en": "word formation"
  },
  "vortope": {
    "en": "literally, word for word"
  }
  ...
}

database

The ido table in the SQLite database, ido.db, has the following general format:

Table 1. Column names correspond to data options and each row represents a word.

en	io	semantiko	exemplaro
language	lingu.o	Vortaro e sintaxo propra a komuneso.	matrala linguo intermixo di lingui
morphology	morfologi.o	(biol., filoz.) Cienco di la diversa formi di materio. (gram.) Cienco di la diversa formi gramatikala di la vorti.

Note that the io column encodes the morphology of a word by delimiting its segments with the full stop character (or, "period": .); multiple definitions, examples, synonyms, etc., should be separated by a newline.

contributing

If you have any thoughts on the project or want to get involved in any way, reach out to us! We’re social animals, we promise.

pri

The initial data set has been scraped from an Ido Wiktionary data dump. However, due to Wikimedia’s format prioritizing human legibility over machine parsability, much of the data was either completely dropped or just plain corrupted by the parsing process; it is for this reason that we believe Wiktionary to be a poor choice for data storage and retrieval.

Ido will never grow as a language if we cannot write decent programs for it. That is what this repo is all about: a unified resource for universal access.