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. |
Requests are constructed in the following manner:
https://api.linguo.io/query/data
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.
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).
The usual HTTP methods will not surprise you.
-
GET: lektar
Warning
|
The following are not yet implemented: |
-
POST: krear
-
PUT: skribar
-
DELETE: efacar
Note
|
These examples include extra formatting for legability. |
To return the definition of linguo, with example usage:
{
"lingu.o": {
"exemplaro": [
"matrala linguo"
"intermixo di lingui",
],
"semantiko": "Vortaro e sintaxo propra a komuneso."
}
}
To return matches of the Russian word язык:
{
"lingu.o": {
...
"io": "linguo",
...
"ru": "язык",
...
}
}
To return the English translation of every word that begins with vort:
{
"vortala": {
"en": "verbal"
},
"vortifo": {
"en": "word formation"
},
"vortope": {
"en": "literally, word for word"
}
...
}
The ido
table in the SQLite database, ido.db
, has the following general format:
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": .
).
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.
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.