kyegupov / api

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.

format

Requests are constructed in the following manner:

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

query

Preceeding 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 preceeded by a tilde, it is interpreted as a regular expression.

data

The data options are:

semantiko	definitions
morfologio	how the words are constructed
exemplaro	a few examples of usage
sinonimo	words with similiar 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:

• POST: krear

• PUT: skribar

• DELETE: efacar

examples

Note	These examples include extra formatting for legability.

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\nintermixo di lingui
morphology	morfologi.o	(biol., filoz.) Cienco di la diversa formi di materio.\n(gram.) Cienco di la diversa formi gramatikala di la vorti.

where \n is the character for a newline (that is, multiple definitions and examples should be seperated by a newline character). Note that the io column encodes (or, will encode when that change is made) the morphology of a word by delimiting its segments with the full stop character (or, "period": .).

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 legability 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.